Det besøkende har skrevet til deg: innsendte kontaktskjemaer og chat-samtaler. Du kan lese dem, si fra at du har tatt hånd om en av dem, svare i chat og slette. Uten abonnement svarer rutene 409 komplett-plan-required i stedet for en tom liste. Chat finnes bare på Komplett, så på Enkel er chat-lista tom uten at noe er galt. Hvert oppslag og hver sletting logges med nøkkelens id, som på abonnentlista.
Krever en publikasjon satt opp som nettsted. Meldinger krever i tillegg et abonnement, Enkel eller Komplett. Krever et abonnement på nettstedet. Kontaktskjemaet følger med både Enkel og Komplett, chat bare med Komplett.
Kodeeksemplene kaller en skribb-funksjon du setter opp selv. Hent klienten for språket ditt og lim den inn én gang, så kan eksemplene under limes rett etter.
Uten kind får du begge deler. Dette er et øyeblikksbilde og blar ikke: to lister i én body kan ikke dele én cursor, så du får de nyeste limit av hver. Skal du lese hele postkassa, eller spørre igjen med jevne mellomrom, bruk /messages/kontakt og /messages/chat, som har cursor.
Slik sier du fra at du har tatt hånd om en henvendelse, så den ikke ligger som ny i innboksen til skaperen også. replied kan du sette selv: har du svart den besøkende fra ditt eget system, er det sant, og alternativet er en innboks som er uenig med det som faktisk skjedde. replied_at settes samtidig.
Dette er ikke arkivering. Meldingen er borte, og det finnes ingen kopi noe annet sted. Bruk archived hvis du bare vil ha den ut av lista. Sletting logges med nøkkelens id.
Sist aktive først, med cursor. Meldingene er IKKE med: en tråd kan ha 300 av dem, så en side med 50 samtaler ville dratt med seg femten tusen rader for deg som bare ville vite hvem som har skrevet. Hent den enkelte samtalen for tråden. updated_since sammenlikner med last_message_at, som bumpes hver gang noen skriver, uansett hvem.
?status
open eller closed. Utelat for begge.
?updated_since
ISO 8601. Bare samtaler med aktivitet etter dette.
Svaret legger seg i tråden, og den besøkende ser det neste gang widgeten spør. Det er hele kanalen: tråden som ligger her, er samtalen, for begge parter. Derfor kan denne ruta svare, mens et svar på et kontaktskjema ikke kan. Det går ut som e-post, og hvilken adresse den besøkende svarer tilbake til, er ikke et valg en nøkkel skal ta. Har du svart på et skjema fra ditt eget system, sier du fra med PATCH og status replied. Sender du Idempotency-Key, sier vi ikke det samme to ganger til den besøkende om svaret ditt går tapt på veien.
Bodyen du sender
bodystringpåkrevd
Teksten. Opptil 2000 tegn, samme grense som widgeten og innboksen har.
# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
chat_id="cnv_7Pq1"skribb"/messages/chat/$chat_id/svar" \
-X POST \
-H "content-type: application/json" \
-d '{
"body": "Takk for at du tok kontakt."
}'
closed betyr håndtert for nå, ikke ferdig for godt: skriver den besøkende igjen, åpner tråden seg selv. Det er widgetens egen regel, og den kan ikke overstyres herfra, så en integrasjon som spør etter status=open, vil se tråden komme tilbake hvis den besøkende ikke var ferdig. Svaret er samtalen uten meldingene: en statusendring er ingen grunn til å sende deg tre hundre meldinger du allerede har.
Hele tråden går med. Den besøkendes kopi også, for widgeten leser tråden herfra og har ingen egen. Dette kan ikke angres. Sletting logges med nøkkelens id.
Hele tråden, eldste først. Den besøkendes tilgangspolett er ikke med: den er ikke en identifikator, men en nøkkel som ville latt den som holder den, lese og skrive som den besøkende.