easyCoexistence
Prijavite seZapočnite besplatno probno razdoblje
Meta Tech Provider

Webhook za messages

messages je polje koje prenosi sve što korisnik pošalje na vaš broj: tekst, medije, odgovore, reakcije i interaktivne odgovore. Na usmjerenom Coexistence broju ide iz Mete izravno na vaš endpoint i nikad ne prolazi kroz pružatelja.

messages

Webhook polje koje prenosi dolazne poruke korisnika.

wamid

Prefiks uz id poruke koji se koristi za uklanjanje duplikata ponovljenih zahtjeva.

200

Status koji Meta brzo očekuje, prije bilo kakve obrade.

Što payload sadrži

Jednu ili više poruka u jednoj isporuci, a svaka sadrži pošiljatelja, id i vrstu. Vrsta određuje koji su drugi ključevi prisutni.

  • Telefonski broj pošiljatelja i id telefonskog broja kojem je poruka poslana.
  • wamid id poruke, na kojem se temelji uklanjanje duplikata.
  • unix vremensku oznaku.
  • Vrstu: text, image, audio, video, document, sticker, location, contacts, reaction, button ili interactive.
  • Za medijske vrste, id medija koji se dohvaća umjesto samih bajtova.

Zašto na usmjerenom broju nikad ne stiže nama

Zato što override premješta ovo polje, zajedno s poljem smb_message_echoes, na odredište koje odredite.

Meta aplikaciji omogućuje da promijeni mjesto na koje WhatsApp Business Account dostavlja webhookove. Taj override postavljamo na vaš URL, čime se put poruke u potpunosti uklanja iz naše infrastrukture. Na našoj strani nema kopije, reda čekanja ni zadržavanja jer isporuka nikad ne stiže do nas.

Kad odredište nije postavljeno, ti se događaji vraćaju na naš zadani callback, gdje ih handler odbacuje bez spremanja. To je razlika između tvrdnje o pohrani i puta kroz kôd: sadržaj razgovora nema kamo otići.

Ispravno potvrđivanje primitka

Vratite 200 prije obrade, a ne nakon nje.

Meta spori odgovor smatra pogreškom i ponavlja zahtjev, što znači da će handler koji obrađuje zahtjev unutar iste operacije istu poruku vidjeti više puta. Odmah odgovorite, stavite payload u red čekanja ili pozadinski zadatak i obradite ga izvan zahtjeva.

Na poslužitelju bez trajnog procesa to nije izborno. Funkcija koja vrati odgovor pa nastavi raditi može biti zamrznuta čim odgovori, zato potvrđivanje i obrada moraju biti uistinu odvojeni.

Uklanjanje duplikata

Uvijek prema wamid-u jer su ponovljeni zahtjevi uobičajeni, a ne iznimka.

Ista poruka može stići dvaput zbog razloga koji nemaju veze s pogreškom na vašoj strani: spor odgovor, istek vremena mrežnog zahtjeva ili implementacija tijekom isporuke. Spremanje već viđenih id-jeva i preskakanje ponavljanja zahtijeva nekoliko redaka i čini razliku između toga da korisniku odgovorite jednom ili dvaput.

Na Coexistence broju to je još važnije jer smb_message_echoes stiže istim putem, a handler koji svaki događaj smatra novim odgovorit će povrh odgovora koji je osoba iz vašeg tima već poslala.

Uobičajene pogreške

  • Obrada prije vraćanja 200. Meta ponavlja spori odgovor pa poruku obrađujete dvaput.
  • Preskakanje uklanjanja duplikata. Ponovljeni zahtjevi dio su dizajna, a ne rubni slučaj.
  • Očekivanje bajtova medija u payloadu. On sadrži id medija koji se dohvaća.
Radite ovo uz EasyCoexistence

EasyCoexistence usmjerava ovo polje izravno iz Mete na vaš endpoint i zadržava samo operativne događaje potrebne za nadzor, pa sadržaj razgovora uopće nema put do naše pohrane.

Često postavljana pitanja

Vidi li EasyCoexistence poruke mojih korisnika?

Ne. Override ovo polje dostavlja na vaš endpoint. Sve što stigne do našeg rezervnog callbacka odbacuje se bez spremanja.

Može li u jednom zahtjevu stići više poruka?

Da. Jedna isporuka može sadržavati više poruka, zato handleri trebaju proći kroz sve, a ne čitati samo prvu.

Kako dohvaćam medij?

Payload sadrži id medija. Njime dohvatite URL koristeći pristupni token broja, a zatim preuzmite medij.

Što je smb_message_echoes?

Prateće polje koje prenosi ono što vaš tim šalje iz aplikacije WhatsApp Business. Postoji samo na Coexistence brojevima.

Nastavite čitati

Spremni za početak?

Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.

Započnite besplatno probno razdoblje

Provjereno na

Webhook za messages