Tīmekļa āķi FoodSoul API: CRM pati paziņo jūsu servisiem par jaunajiem notikumiem

Tagad FoodSoul pats nosūta paziņojumus jūsu sistēmām, kad CRM notiek kādas izmaiņas. Piemēram, ir saņemts jauns pasūtījums, klients ir samaksājis vai atgriezis naudu, reģistrējies jauns viesis. Pietiek vienreiz norādīt sava servisa adresi, un dati uzreiz tiks nosūtīti uz grāmatvedības sistēmu, jūsu botu, otru CRM vai analītiku.

Par kādiem notikumiem var saņemt paziņojumus

1. Jauns pasūtījums ar pilnu kartīti. Noderēs grāmatvedības sistēmai, virtuvei un analītikai.
2. Pasūtījuma statusa maiņa. Derēs botam, kas informē klientu par pasūtījumu, un zvanu centram.
3. Maksājuma statusa maiņa, ieskaitot atgriešanu. Nepieciešams grāmatvedībai un finanšu uzskaitei.
4. Jauns klients un viņa datu izmaiņas. Ārējai CRM un izsūtīšanas servisiem.
5. Bonusu piešķiršana, norakstīšana un dzēšana. Lojalitātes programmai un komunikācijai ar viesiem.
6. Jauna atsauksme. Vadītājam un kvalitātes dienestam.
7. Kurjera piešķiršana. Loģistikai un klienta paziņojumiem.
8. Stop-listes izmaiņas. Mājaslapai, virtuvei un pārdošanas platformām.
9. Filiale pārtrauc vai atsāk pasūtījumu pieņemšanu. Operatīvai kontrolei un tīkla vadībai.

Jūs paši izvēlaties, par kuriem notikumiem saņemt paziņojumus. Var pieslēgt tikai nepieciešamos, piemēram, “jauns pasūtījums” un “apmaksa”. Neatradāt vajadzīgo notikumu? Rakstiet mums — mēs ar prieku to pievienosim.

Kā pieslēgt

1. Ieslēdziet webhook'us vajadzīgajai filiālei — paraksta atslēga tiks izveidota automātiski.
2. Izvēlieties notikumus, par kuriem vēlaties saņemt paziņojumus.
3. Norādiet sava servisa adresi, uz kuru FoodSoul sūtīs datus. Derēs tikai HTTPS adrese.
4. Pievienojiet paraksta atslēgu servisam, kas saņem paziņojumus, un iestatiet paraksta pārbaudi. Ja webhook'u izveides laikā norādījāt dažādas adreses, pievienojiet atslēgu katram servisam.
5. Pārliecinieties, ka serviss apstiprina paziņojuma saņemšanu 10 sekunžu laikā, citādi FoodSoul to nosūtīs atkārtoti.

6. Iestatiet atkārtojumu pārbaudi: viens un tas pats paziņojums var atnākt vairākas reizes. Visām atkārtojumam ir vienāds ID (galvene X-Webhook-ID). Lai jūsu serviss atceras apstrādāto paziņojumu ID un izlaiž atkārtojumus — tā viena apmaksa netiks veikta divreiz.

    

Drošība: kāpēc vajadzīga paraksta atslēga
 

FoodSoul paraksta katru paziņojumu ar paraksta atslēgu — simbolu kopu, kas ir tikai jums un mums. Pēc šī paraksta jūsu sistēma pārbauda, ka paziņojums ir no FoodSoul un pa ceļam nav ticis mainīts.
 

Pieprasījumu uz jūsu servisa adresi var nosūtīt jebkurš. Piemēram, krāpnieks nosūtīs viltotu paziņojumu “pasūtījums apmaksāts”, un jūs izsniegsiet neapmaksātu pasūtījumu.
 

Ar parakstu tas neizdosies. Jūsu serveris aprēķina parakstu ar to pašu atslēgu un salīdzina to ar saņemto. Ja paraksti nesakrīt, tātad paziņojums ir viltots vai mainīts.

 

Ja kaut kas noiet greizi

• Ja jūsu serviss īslaicīgi nav pieejams, FoodSoul vēl vairākas reizes mēģinās piegādāt paziņojumu 10 stundu laikā. Īss pārtraukums vai servera pārstartēšana nenovedīs pie notikumu zuduma.
• Ja problēma ieilgs, abonements tiks atslēgts, un jūs saņemsiet vēstuli: tā jūs uzzināsiet par problēmu.
• Lai atkal ieslēgtu abonementu, rakstiet tehniskajam atbalstam. Turpat var atkārtoti nosūtīt paziņojumus, kas netika piegādāti pārtraukuma laikā.
   

Detalizēts notikumu un datu formāta apraksts — API dokumentācijā.

Ar cieņu, FoodSoul komanda! Mēs strādājam Jums!