En bref
- Neuf événements au choix.Conversations, messages, passage à un humain, statut, leads, contacts, notes, réservations et usage.
- Signés selon un standard ouvert.Chaque envoi suit Standard Webhooks, pour que votre serveur puisse prouver qu'il vient de OneType.
- Nouvelles tentatives pendant environ trois jours.Un envoi échoué est retenté selon un calendrier de 5 secondes jusqu'à 24 heures.
- Un journal que vous pouvez rejouer.Voyez chaque tentative pendant 30 jours et renvoyez n'importe quel événement en un clic.
Un lead qui ne reste que dans un outil de chat est un lead qu'on oublie. Un webhook est un message que OneType envoie à une adresse de votre serveur chaque fois que quelque chose se passe. Servez-vous-en pour ajouter des leads à votre CRM, ouvrir des tickets, prévenir votre équipe ou mettre à jour un tableau de bord, sans que personne ne copie des données à la main.
Les événements
- conversation.created : un visiteur démarre une conversation.
- conversation.message.created : un message est terminé, par le visiteur, l'agent ou votre équipe.
- conversation.handoff.requested : le visiteur ou l'agent demande une personne (passage à un humain).
- conversation.status.changed : ouverte, escaladée, résolue, non résolue ou échouée.
- lead.captured et contact.identified : un visiteur laisse ses coordonnées ou est reconnu comme l'un de vos utilisateurs connectés.
- usage.threshold.reached : votre espace de travail atteint 80 % ou 100 % de son usage mensuel.
Chaque envoi porte le même objet que celui renvoyé par l'API REST pour cette ressource, si bien qu'un message indique s'il a été écrit par une IA. Vous pouvez abonner un endpoint à certains événements ou à tous.
Configurez-le dans le tableau de bord
Dans « Developer », « Webhooks », un propriétaire ou un admin ajoute une adresse https et choisit les événements. Le secret de signature n'est affiché qu'une fois, enregistrez-le donc tout de suite. Cliquez sur « Send test » pour envoyer un ping signé et voir le code de réponse et le temps de réponse. Vous pouvez renouveler le secret à tout moment : pendant 24 heures, l'ancien et le nouveau secret signent chaque envoi, donc rien ne casse pendant la transition.
Des envois fiables
Répondez par n'importe quel 2xx en moins de 10 secondes et l'envoi est compté. Si votre serveur échoue ou est lent, OneType réessaie après 5 secondes, 30 secondes, 2 minutes, 10 minutes, 30 minutes, 1 heure, 3 heures, 6 heures, 12 heures, puis trois fois toutes les 24 heures. L'envoi est garanti au moins une fois, conservez donc l'en-tête webhook-id, identique à chaque nouvelle tentative, et ignorez les répétitions. L'ordre n'est pas garanti.
Un endpoint qui n'enregistre que des échecs pendant trois jours est désactivé, et les propriétaires voient une bannière avec « Turn back on ». Le journal des envois conserve chaque tentative 30 jours avec statut, code, temps de réponse et extrait de la réponse, et « Redeliver » renvoie un événement.
Sécurité
Chaque requête est signée selon Standard Webhooks avec un horodatage, vous pouvez donc rejeter les requêtes anciennes ou rejouées. OneType ne livre qu'à des adresses https publiques, jamais à des réseaux privés, et ne suit pas les redirections. Les docs développeurs incluent du code de vérification pour Node.js, Python et PHP.
Idées pour votre premier endpoint
- Ajoutez chaque contact lead.captured à votre CRM ou à votre liste d'e-mailing.
- Ouvrez un ticket dans votre helpdesk pour chaque passage à un humain (conversation.handoff.requested).
- Alertez le canal de votre équipe quand une conversation est escaladée.
- Prévenez la finance quand usage.threshold.reached arrive.
Seuls les propriétaires et les admins peuvent voir et gérer les endpoints, et les secrets ne sont plus jamais affichés après la première fois. Les autres collègues ne voient pas du tout les webhooks.