Integrare Webhook de intrare

Creat pe15 martie 2021

TimelinesAI vă permite să automatizați trimiterea de mesaje WhatsApp ca răspuns la evenimente sau acțiuni în instrumentele pe care le utilizați deja: CRM, asistență, sisteme de recrutare etc.

Evenimentul "Trimite mesaj"

Este posibil să instruiți TimelinesAI să trimită un mesaj (cu sau fără atașament de fișier) unui anumit contact (poate fi un grup). În cazul în care în spațiul de lucru sunt conectate mai multe conturi WhatsApp, este posibilă, de asemenea, specificarea unui anumit cont WhatsApp care să fie utilizat pentru trimiterea mesajului.

Pentru a configura integrarea, proprietarul unui spațiu de lucru trebuie să navigheze în ecranul "Integrations / Inbound Webhooks" și să genereze un nou URL. Sistemul extern ar trebui să posteze un mesaj în format specific (a se vedea detaliile de mai jos) la acel URL.

Limitări

Dimensiunea maximă a atașamentului este de 2 MB.
Nu există o validare imediată a formatului numărului de telefon al destinatarului sau a conexiunii cu WhatsApp. Navigați în interfața Timelines UI pentru a verifica starea de trimitere/citire a mesajelor.

Trimiterea de fișiere prin intermediul Webhooks de intrare

Trimiterea unui fișier: Descărcare directă vs. Servicii de găzduire a fișierelor

Este imperativ să trimiteți fișiere utilizând linkuri de descărcare directă. Acest lucru permite destinatarului să primească efectiv fișierul.

În schimb, ar trebui utilizat un serviciu de găzduire a fișierelor, astfel încât acesta să poată furniza un link de descărcare directă. Un astfel de link este cel mai bine testat prin navigare incognito/privată; prin introducerea linkului în bara de căutare. În cazul în care descărcarea fișierului începe imediat, link-ul este acceptabil. Dacă, în schimb, este afișată orice fel de pagină web, atunci, link-ul nu poate fi utilizat pentru trimiterea de fișiere.

În cazul linkurilor de la File Hosting Service, fișierele nu pot fi descărcate. Ceea ce se descarcă și se trimite în schimb este o pagină web de partajare, ceea ce poate duce la un fișier "corupt".

Acest lucru, la rândul său, vă va afecta mesajul, deoarece destinatarii nu pot accesa mediile pe care le trimiteți, făcând fișierele inutilizabile. Astfel, este esențial să vă asigurați că trimiteți linkuri de descărcare directă, deoarece acest lucru le va permite să acceseze fișierul fără probleme.

De asemenea, puteți efectua acest test trimițând un mesaj webhook la unul dintre numerele de test. Veți putea determina modul în care se va comporta fișierul pe baza a ceea ce am analizat aici; dacă primiți un mesaj de eroare precum "File is Corrupted", "Incompatible File"; sau "Failed to load X document", după ce faceți clic pe atașament, atunci acesta este un link de serviciu de găzduire a fișierelor și trebuie înlocuit cu un link de descărcare directă.

Utilizarea creditului

Trimiterea unui mesaj consumă 1 credit din cota de trimitere a mesajelor.
Trimiterea unui mesaj cu text și atașament necomplet consumă 2 credite din cota de trimitere a mesajelor.
Dacă un mesaj nu poate fi trimis (număr WhatsApp invalid sau neconectat, eroare de server WhatsApp), cota de trimitere a mesajelor va fi restabilită (de obicei, în câteva ore).

Rata de trimitere a mesajelor

Mesajele vor fi trimise cu o întârziere aleatorie de aproximativ 2 secunde între fiecare două mesaje (pentru a evita mecanismele de detectare a spam-ului din WhatsApp).
Dacă activați webhooks cu o frecvență mai mică de 2 secunde, mesajele vor fi puse în coadă și trimise cu întârziere. Fiecare mesaj din coada de așteptare va consuma un credit de trimitere a mesajelor, astfel încât numărul de mesaje din coada de așteptare nu poate depăși cota disponibilă.

Configurația și acțiunile Webhook

"Webhook activat" - permite dezactivarea webhook-ului fără a-l elimina complet
"Generate new URL" - va crea un nou URL unic, care va accepta notificări. URL-ul anterior nu va mai fi disponibil.
"Ultimele încercări de trimitere" - starea ultimelor încercări de activare a webhook-ului
"Download log" (Jurnal de descărcare) - un jurnal detaliat al ultimelor 100 de încercări de activare, util pentru depistarea problemelor de formatare.

Formatul de solicitare Webhook

Webhook acceptă date în format JSON, prin intermediul unei cereri POST.

"action" (obligatoriu) - în prezent, este acceptată doar o singură valoare posibilă, "send".
"text" (obligatoriu) - un mesaj codificat în text simplu UTF-8 care urmează să fie trimis (nu se acceptă markdown, cu excepția separatorului de linii "\n"), poate fi lăsat gol, dacă este specificat fișierul.
"file_url" (opțional) - o adresă URL accesibilă publicului a unui fișier care va fi descărcat și trimis ca atașament.
"nume_fișier" (opțional) - un nume pentru atașament (trebuie furnizat dacă se specifică URL).

Destinatarul poate fi specificat prin furnizarea unuia dintre următorii parametri:

"chat_id" - un id al chat-ului, așa cum apare în TimelinesAI (poate fi găsit în URL-ul paginii de chat sau în sarcina utilă a webhook-ului de ieșire). Aceasta acceptă trimiterea de mesaje către un grup.
"jid" - un JID WhatsApp care specifică un contact sau un grup
"phone" - un număr de telefon, formatat în conformitate cu standardul internațional de numere de telefon, adică:
[+][indicativul țării][indicativul zonei][numărul de telefon local] (de exemplu: +14151231234)
"chat_name" - un nume exact al chat-ului așa cum apare în TimelinesAI

În cazul în care în spațiul de lucru sunt conectate mai multe conturi WhatsApp, utilizați următorul parametru suplimentar pentru a specifica contul WhatsApp care urmează să fie utilizat:

"whatsapp account phone" (opțional) - specifică (ca număr de telefon, în format internațional) contul de WhatsApp pe care îl utilizăm pentru trimitere. Dacă se omite, pentru trimitere se va utiliza contul WhatsApp activ cel mai recent conectat în spațiul de lucru. Notă: dacă este specificat parametrul "chat_id", "whatsapp account phone" nu va fi luat în considerare, deoarece fiecare chat este deja conectat la un anumit cont WhatsApp.

Răspunsul Webhook

În caz de succes (cererea a fost validată și acceptată pentru trimitere), Webhook va răspunde cu statusul HTTP 200 și JSON, conținând message_id al mesajului creat:

{
    "status": "success",
    "data": {
        "message_id": "wa_backend:3EB09FCC85FE99662E46"
    }
}

În caz de eroare, Webhook va răspunde cu starea HTTP 40X și JSON cu detalii despre eroare, de exemplu:

{
"status": 40X,
"data": {},
"message": "Webhook not found"
}

Exemple

Exemplul 1 - trimiterea unui mesaj prin intermediul unui anumit cont WA către un anumit număr de telefon:

{
"action": "send",
"whatsapp account phone" : "+15105566777", 
"phone": "+14151231234", 
"text": "lorem ipsum"
}

Exemplul 2 - trimiterea unui mesaj cu text și atașament către un chat (sau grup) specificat prin id:

{
"action": "send", 
"chat_id": "77234", 
"text": "lorem ipsum"
"file_url" : "https://150588669.v2.pressablecdn.com/logo.png",
"file_name" : "logo.png"
}

Autor
Mesaje recente

admin

Ultimele postări de admin (vezi toate)

Cum vă putem ajuta?