Webhook in entrata

I webhook permettono a yourang.ai di notificare il tuo sistema esterno appena qualcosa succede, senza bisogno di polling. Il modello è semplice: tu registri un URL, yourang.ai ci manda una richiesta HTTP POST ad ogni evento di interesse.

Perché webhook invece di polling

Senza webhook, il tuo sistema dovrebbe chiamare l'API ripetutamente per chiedere 'è successo qualcosa di nuovo?'. È inefficiente, costoso e introduce ritardi. Con i webhook ricevi la notifica in pochi millisecondi dall'evento, con il payload già pronto.

Eventi disponibili

• Chiamata terminata (con trascrizione, riepilogo, esito)
• Nuova prenotazione
• Modifica prenotazione
• Cancellazione prenotazione
• Nuovo ordine
• Aggiornamento stato ordine
• Nuovo contatto creato
• Aggiornamento campi contatto
• Esito di criterio di valutazione
• Workflow completato

Configurare un webhook

1. 1

   Implementa l'endpoint nel tuo sistema

   Una URL pubblica HTTPS che riceve POST. Deve rispondere 200 OK quando l'evento è stato accettato.

2. 2

   Registra l'URL in yourang.ai

   Vai a Amministrazione → API → Webhook, inserisci l'URL e seleziona gli eventi di interesse.

3. 3

   Verifica la firma

   Ogni payload viene firmato con un secret condiviso. Il tuo endpoint deve validare la firma per garantire che il messaggio venga davvero da yourang.ai.

4. 4

   Testa con eventi reali

   Il pannello mostra il log delle ultime consegne con esito (200 OK, errori). Usa questo log per debugging.

Retry e affidabilità

Se il tuo endpoint risponde con errore o non risponde in tempo, yourang.ai riprova automaticamente seguendo una strategia con backoff esponenziale (es. 30 secondi, 5 minuti, 1 ora, ...). Dopo alcuni tentativi falliti, l'evento finisce in dead letter queue per intervento manuale. Sull'endpoint, conviene rispondere 200 OK subito e processare in modo asincrono per evitare timeout.