Det besøkende har skrevet til deg: innsendte kontaktskjemaer og chat-samtaler. Chat er et tillegg, så uten det er chat-lista tom uten at noe er galt. Hvert oppslag og hver sletting logges med nøkkelens id.
Krever en publikasjon satt opp som nettsted. Meldinger krever i tillegg en pakke, Skribb Litt eller Skribb Mer. Krever en pakke på nettstedet. Kontaktskjemaet følger med både Skribb Litt og Skribb Mer; chat er et tillegg publikasjonen legger til.
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. 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. 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. Et kontaktskjema har ingen slik rute: svaret der 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 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."
}'
Svarene skaperen har lagret for å sette inn når de svarer, sortert etter navn. Svarmaler følger med Skribb Mer: uten den svarer ruta 409 mer-plan-required i stedet for en tom liste, så du kan si hvorfor. Malene skrives og endres i oversikten, ikke her.
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.
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.