WhatsApp-numre, svar og avmeldinger

Én Mailhuset-konto kan ha flere WhatsApp-numre, for eksempel ett per produkt eller merkevare. Hvert nummer har sine egne samtaler og avmeldinger, og hvis du gir det til et prosjekt, også sine egne webhooks og API-nøkler.

Gi et nummer til et prosjekt

Åpne WhatsApp → Oversikt. Hvert nummer har innstillingen Prosjekt:

• Delt av alle prosjekter (standard): alle prosjektenes API-nøkler kan sende fra nummeret, og svar til det går til alle webhook-endepunktene på kontoen.
• Et prosjekt: svar til nummeret går bare til det prosjektets webhook-endepunkter, og bare det prosjektets API-nøkler kan sende fra det. En nøkkel fra et annet prosjekt som oppgir nummeret, får 403 med koden WHATSAPP_SENDER_OTHER_PROJECT.

Du kan også endre det via API-et:

PATCH /v1/whatsapp/senders/{id}
{ "projectId": "proj_123" }

Send "projectId": null for å dele nummeret igjen.

Hvilket nummer en melding sendes fra

Oppgi senderId på POST /v1/whatsapp for å velge nummer. Uten det bruker Mailhuset det eldste tilkoblede nummeret i nøkkelens prosjekt, og hvis prosjektet ikke har noe, det eldste delte nummeret.

Svar du sender fra innboksen i dashbordet, går alltid ut fra nummeret samtalen er på.

Webhook-hendelser

WhatsApp-hendelser kommer til webhook-endepunktene dine på samme måte som e-posthendelser:

Alle WhatsApp-hendelser har senderId, nummeret meldingen ble sendt fra eller mottatt på. whatsapp.inbound har også:

• phone: hvem som skrev til deg.
• to: nummeret de skrev til.
• inboundId: Mailhusets id for meldingen. Den er lik ved hvert nytt forsøk, så bruk den til å se bort fra duplikater. Den er også id-en for å laste ned media med GET /v1/whatsapp/inbound/{inboundId}/media.
• text, eller media med type, filnavn og bildetekst.

Avmeldinger gjelder per nummer

Når noen svarer STOP til et av numrene dine, blir de meldt av bare det nummeret. De andre numrene dine kan fortsatt sende til dem.

Du kan også registrere samtykke selv, under WhatsApp → Samtykke eller med POST /v1/whatsapp/opt-ins:

• Med senderId gjelder påmeldingen eller avmeldingen bare det nummeret.
• Uten gjelder den alle numrene på kontoen.

Når begge finnes for samme telefon, vinner nummerets egen registrering. En telefon som er meldt av alle numre, kan derfor meldes på igjen for ett nummer, og en STOP til ett nummer blir aldri opphevet av en påmelding for hele kontoen.

24-timersvinduet

Fritekst kan bare sendes innen 24 timer etter personens siste melding til det samme nummeret. Utenfor vinduet må du sende en godkjent mal. Vinduet følges per nummer, så en melding til ett nummer åpner ikke et vindu på et annet.

Trenger du hjelp? Send e-post til support@mailhuset.com.