Webhook nell'API FoodSoul: il CRM informa autonomamente i vostri servizi sui nuovi eventi

Ora FoodSoul invia automaticamente notifiche ai vostri sistemi quando accade qualcosa nel CRM. Ad esempio, arriva un nuovo ordine, il cliente paga o riceve un rimborso, si registra un nuovo ospite. Basta indicare una sola volta l’indirizzo del vostro servizio e i dati verranno subito inviati al sistema di contabilità, al vostro bot, a un secondo CRM o all’analisi.

Per quali eventi è possibile ricevere notifiche

1. Nuovo ordine con scheda completa. Utile per il sistema di contabilità, la cucina e l’analisi.
2. Cambio di stato dell’ordine. Adatto per un bot che informa il cliente sull’ordine e per il call center.
3. Cambio di stato del pagamento, incluso il rimborso. Necessario per la contabilità e la gestione finanziaria.
4. Nuovo cliente e modifica dei suoi dati. Per CRM esterni e servizi di mailing.
5. Accredito, addebito e scadenza dei bonus. Per il programma fedeltà e la comunicazione con gli ospiti.
6. Nuova recensione. Per il responsabile e il servizio qualità.
7. Assegnazione del corriere. Per la logistica e le notifiche al cliente.
8. Modifica della lista degli articoli non disponibili. Per il sito, la cucina e le piattaforme di vendita.
9. La filiale ha sospeso o ripreso l’accettazione degli ordini. Per il controllo operativo e la direzione della rete.

Siete voi a scegliere quali eventi ricevere. Potete attivare solo quelli necessari, ad esempio “nuovo ordine” e “pagamento”. Non trovate l’evento che vi serve? Scriveteci — saremo lieti di aggiungerlo.

Come collegarsi

1. Attivate i webhook per la filiale desiderata — la chiave di firma verrà creata automaticamente.
2. Selezionate gli eventi per cui desiderate ricevere notifiche.
3. Indicate l’indirizzo del vostro servizio a cui FoodSoul invierà i dati. È valido solo un indirizzo HTTPS.
4. Aggiungete la chiave di firma al servizio che riceve le notifiche e configurate la verifica della firma. Se durante la creazione dei webhook avete indicato indirizzi diversi, aggiungete la chiave a ciascun servizio.
5. Assicuratevi che il servizio confermi la ricezione della notifica entro 10 secondi, altrimenti FoodSoul la invierà nuovamente.

6. Configurate il controllo dei duplicati: la stessa notifica può arrivare più volte. Tutti i duplicati hanno lo stesso ID (intestazione X-Webhook-ID). Il vostro servizio deve memorizzare gli ID delle notifiche già elaborate e ignorare i duplicati — così un pagamento non verrà registrato due volte.

    

Sicurezza: a cosa serve la chiave di firma
 

FoodSoul firma ogni notifica con una chiave di firma — una sequenza di caratteri che solo voi e noi possediamo. Grazie a questa firma, il vostro sistema verifica che la notifica provenga da FoodSoul e che non sia stata modificata durante il tragitto.
 

Chiunque può inviare una richiesta all’indirizzo del vostro servizio. Ad esempio, un truffatore potrebbe inviare una falsa notifica “ordine pagato” e voi consegnereste un ordine non pagato.
 

Con la firma questo non accadrà. Il vostro server calcola la firma con la stessa chiave e la confronta con quella ricevuta. Se le firme non coincidono, la notifica è falsa o alterata.

 

Se qualcosa va storto

• Se il vostro servizio è temporaneamente non disponibile, FoodSoul proverà a consegnare la notifica più volte nell’arco di 10 ore. Un breve malfunzionamento o il riavvio del server non comporteranno la perdita degli eventi.
• Se il problema persiste, l’abbonamento verrà disattivato e riceverete una mail: così sarete informati del problema.
• Per riattivare l’abbonamento, scrivete all’assistenza tecnica. Da lì potrete anche reinviare le notifiche che non sono state recapitate durante il disservizio.
   

Descrizione dettagliata degli eventi e del formato dei dati — nella documentazione API.

Cordiali saluti, il team di FoodSoul! Lavoriamo per voi!