Webhook wiadomości

Co zawiera payload

Jedno lub więcej wiadomości w ramach jednej dostawy, każda z nadawcą, identyfikatorem i typem. Typ określa, które pozostałe klucze są obecne.

• Numer telefonu nadawcy oraz identyfikator numeru telefonu, na który wysłano wiadomość.
• Identyfikator wiadomości wamid, na którym opiera się deduplikacja.
• Znacznik czasu unix.
• Typ: text, image, audio, video, document, sticker, location, contacts, reaction, button lub interactive.
• W przypadku multimediów identyfikator multimediów do pobrania zamiast samych bajtów.

Dlaczego na przekierowanym numerze nie trafia do nas

Ponieważ nadpisanie przekierowuje to pole wraz z smb_message_echoes do wskazanego przez Ciebie miejsca.

Meta pozwala aplikacji zmienić miejsce dostarczania webhooków konta WhatsApp Business. Ustawiamy to nadpisanie na Twój URL, dzięki czemu ścieżka wiadomości całkowicie omija naszą infrastrukturę. Po naszej stronie nie ma kopii, kolejki ani przechowywania, ponieważ dostawa nigdy tam nie dociera.

Gdy nie ustawisz miejsca docelowego, te zdarzenia trafiają do naszego domyślnego wywołania zwrotnego, gdzie obsługa je odrzuca bez zapisywania. To różnica między twierdzeniem o przechowywaniu a ścieżką kodu: treść rozmowy nie ma dokąd trafić.

Jak poprawnie potwierdzać

Zwróć 200 przed rozpoczęciem pracy, nie po jej zakończeniu.

Meta uznaje wolną odpowiedź za błąd i ponawia żądanie, więc obsługa przetwarzająca je synchronicznie zobaczy tę samą wiadomość więcej niż raz. Odpowiedz natychmiast, umieść payload w kolejce lub zadaniu w tle i wykonaj pracę poza żądaniem.

W środowisku serverless nie jest to opcjonalne. Funkcja, która zwróci odpowiedź, a potem będzie pracować, może zostać zamrożona natychmiast po odpowiedzi. Potwierdzenie i przetwarzanie muszą więc być rzeczywiście rozdzielone.

Deduplikacja

Zawsze na podstawie wamid, ponieważ ponowienia są normą, a nie wyjątkiem.

Ta sama wiadomość może dotrzeć dwa razy z powodów niezwiązanych z błędem po Twojej stronie: wolnej odpowiedzi, przekroczenia limitu czasu sieci lub wdrożenia w trakcie dostawy. Zapisywanie znanych identyfikatorów i pomijanie powtórzeń zajmuje kilka wierszy kodu, a decyduje o tym, czy klient otrzyma jedną, czy dwie odpowiedzi.

Na numerze Coexistence ma to jeszcze większe znaczenie, ponieważ smb_message_echoes trafia tą samą ścieżką. Obsługa, która traktuje każde zdarzenie jako nowe, odpowie na wiadomość człowieka, który już udzielił odpowiedzi.

Typowe błędy

• Przetwarzanie przed zwróceniem 200. Meta ponawia wolne żądanie, więc obsłużysz wiadomość dwa razy.
• Pomijanie deduplikacji. Ponowienia są zamierzone, a nie wyjątkowe.
• Oczekiwanie bajtów multimediów w payloadzie. Zawiera on identyfikator multimediów do pobrania.

Najczęściej zadawane pytania

Czytaj dalej