Les webhooks envoient en temps réel les données de vos appels et SMS vers votre propre serveur. Ils sont utiles si vous n'utilisez pas d'intégration CRM, ou si vous voulez alimenter vos tableaux de bord, vos outils internes ou vos automatisations.
- Offre : Advanced ou Max.
- Rôle : Propriétaire ou Administrateur.
- Documentation technique (format des données, authentification) : docs.onoffbusiness.com.
Installer un webhook
- Dans la console, ouvrez Integrations & API.
- Choisissez le webhook voulu : Onoff Call Webhook (fin d'appel), Onoff SMS Webhook ou le webhook de début d'appel.
- Renseignez l'URL de votre serveur qui recevra les requêtes POST (obligatoire).
- Renseignez une clé API (facultative, recommandée) pour vérifier que les requêtes viennent bien d'Onoff. Voir la page Authorization de la documentation.
- Cliquez sur Integrate. Onoff envoie des données de test à votre URL.
Si votre serveur répond correctement, le statut passe à Integrated. Sinon, le webhook n'est pas activé : corrigez l'URL et réessayez.
Webhook d'appels
Un événement est envoyé à la fin de chaque appel, décroché ou non. Il en existe trois types :
| Événement | Quand |
|---|---|
| CDR | Appel terminé, sans enregistrement. |
| VM | Message vocal reçu. Contient le lien et la durée du message. |
| RECORDING | Appel enregistré. Remplace l'événement CDR : mêmes informations, plus le lien de l'enregistrement. |
Chaque événement contient le membre (nom, e-mail, numéro), le numéro du correspondant (et son nom, e-mail et entreprise s'il est dans les contacts du membre), le début, la fin, la durée, la direction (entrant ou sortant), le statut (décroché, manqué, occupé, messagerie vocale…), les notes et les tags.
| Réglage | Effet |
|---|---|
| Send Call Recording | Ajoute le lien de l'enregistrement, si l'enregistrement est activé pour le membre. Le lien arrive 5 à 8 minutes après l'appel et expire au bout de 6 mois : téléchargez les fichiers pour les garder. |
| Include post-call updates : désactivé | Envoi dès la fin de l'appel, avec les notes et tags ajoutés pendant l'appel. |
| Include post-call updates : activé | Envoi 5 minutes après l'appel, avec les notes et tags ajoutés ou modifiés pendant l'appel et dans les 5 minutes qui suivent. |
Détail des champs : documentation du webhook d'appels.
Webhook de SMS
Envoyé immédiatement à chaque SMS envoyé ou reçu, sans mise à jour ultérieure. Il contient :
- le membre (nom, e-mail, numéro Onoff) et le numéro externe ;
- le nom, l'e-mail et l'entreprise du contact, s'il est enregistré dans les contacts Onoff du membre ;
- la date, l'heure, la direction (envoyé ou reçu) et le texte du message.
Ce que votre serveur doit faire
- Répondre 200 OK rapidement : Onoff attend au maximum 1 seconde pour se connecter et 10 secondes pour la réponse.
- En cas d'erreur, Onoff réessaie 4 fois. Après le dernier échec, l'événement est perdu.
- Chaque événement a un identifiant unique : utilisez-le pour ignorer les doublons.
- Vérifiez la clé API à chaque requête.
- Certains champs (contact, notes, tags, message vocal, enregistrement) ne sont envoyés que s'ils existent : votre code doit gérer leur absence.
Supprimer un webhook
- Ouvrez Integrations & API, puis le webhook concerné, onglet Settings.
- Dans « Remove this integration », cliquez sur Remove et confirmez.
Plus aucune donnée n'est envoyée. Les données déjà reçues restent sur votre serveur. Vous pouvez réinstaller le webhook à tout moment.
Articles liés
- Enregistrer vos appels
- Zapier : automatiser vos appels et SMS
- Connecter votre CRM à Onoff Business
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.