Webhook-uri în API-ul FoodSoul: CRM-ul informează automat serviciile dumneavoastră despre evenimentele noi
Acum FoodSoul trimite automat notificări către sistemele dumneavoastră atunci când în CRM se întâmplă ceva. De exemplu, a sosit o comandă nouă, clientul a plătit sau a returnat bani, s-a înregistrat un nou oaspete. Este suficient să specificați o singură dată adresa serviciului dumneavoastră, iar datele vor fi transmise imediat către sistemul de evidență, către botul dumneavoastră, către un al doilea CRM sau către sistemul de analiză.
Despre ce evenimente puteți primi notificări
- Comandă nouă cu fișa completă. Util pentru sistemul de evidență, bucătărie și analiză.
- Schimbarea statusului comenzii. Potrivit pentru botul care informează clientul despre comandă și pentru call-center.
- Schimbarea statusului plății, inclusiv returul. Necesare pentru contabilitate și evidența financiară.
- Client nou și modificarea datelor acestuia. Pentru CRM extern și servicii de newsletter.
- Acordarea, retragerea și expirarea bonusurilor. Pentru programul de loialitate și comunicarea cu oaspeții.
- Recenzie nouă. Pentru manager și serviciul de calitate.
- Atribuirea curierului. Pentru logistică și notificări către client.
- Modificarea listei de stop. Pentru site, bucătărie și platformele pe care vindeți.
- Filiala a oprit sau a reluat primirea comenzilor. Pentru control operațional și conducerea rețelei.
Alegeți singuri ce evenimente doriți să primiți. Puteți conecta doar cele necesare, de exemplu „comandă nouă” și „plată”. Nu ați găsit evenimentul dorit? Scrieți-ne — îl vom adăuga cu plăcere.
Cum se conectează
- Activați webhook-urile pentru filiala dorită — cheia de semnătură se va crea automat.
- Alegeți evenimentele despre care doriți să primiți notificări.
- Specificați adresa serviciului dumneavoastră la care FoodSoul va trimite datele. Este acceptată doar o adresă cu HTTPS.
- Adăugați cheia de semnătură în serviciul care primește notificările și configurați verificarea semnăturii. Dacă la crearea webhook-urilor ați specificat adrese diferite, adăugați cheia în fiecare serviciu.
- Asigurați-vă că serviciul confirmă primirea notificării în decurs de 10 secunde, altfel FoodSoul o va retrimite.
Configurați verificarea duplicatelor: aceeași notificare poate fi primită de mai multe ori. Toate duplicatele au același ID (antetul X-Webhook-ID). Serviciul dumneavoastră ar trebui să memoreze ID-urile notificărilor procesate și să ignore duplicatele — astfel o plată nu va fi procesată de două ori.
Securitate: de ce este necesară cheia de semnătură
FoodSoul semnează fiecare notificare cu ajutorul unei chei de semnătură — un set de caractere pe care îl aveți doar dumneavoastră și noi. Cu această semnătură, sistemul dumneavoastră verifică dacă notificarea a venit de la FoodSoul și dacă nu a fost modificată pe parcurs.
Oricine poate trimite o solicitare către adresa serviciului dumneavoastră. De exemplu, un escroc poate trimite o notificare falsă „comanda a fost plătită” și veți preda o comandă neplătită.
Cu semnătura, acest lucru nu va funcționa. Serverul dumneavoastră calculează semnătura cu aceeași cheie și o compară cu cea primită. Dacă semnăturile nu coincid, înseamnă că notificarea este falsă sau modificată.
Dacă ceva nu a mers bine
- Dacă serviciul dumneavoastră este temporar indisponibil, FoodSoul va încerca de mai multe ori să livreze notificarea timp de 10 ore. O întrerupere scurtă sau o repornire a serverului nu va duce la pierderea evenimentelor.
- Dacă problema persistă, abonamentul va fi dezactivat, iar dumneavoastră veți primi un e-mail: astfel veți afla despre problemă.
- Pentru a reactiva abonamentul, scrieți la suport tehnic. Tot acolo puteți retrimite notificările care nu au ajuns în timpul defecțiunii.
Descrierea detaliată a evenimentelor și a formatului datelor — în documentația API.
Cu respect, echipa FoodSoul! Lucrăm pentru dumneavoastră!