Safina + Webhooks

Qu’est-ce qu’un webhook ?

Un webhook est une requete HTTP que Safina envoie automatiquement a une URL de votre choix lorsqu’un evenement specifique se produit. Au lieu de verifier sans cesse Safina pour de nouvelles donnees (polling), vous recevez les donnees au moment ou elles sont creees.

En pratique : un appel arrive. Safina decroche, mene la conversation, cree un resume. En quelques secondes, votre systeme recoit une requete HTTP avec toutes les donnees pertinentes : nom de l’appelant, motif de l’appel, urgence, coordonnees, actions a entreprendre.

Vous decidez de ce qui se passe avec les donnees. Un nouveau contact dans HubSpot ? Un message Slack a votre equipe ? Une ligne dans Google Sheets ? Un ticket dans votre systeme de support ? Tout est possible, sans effort manuel.

Quelles donnees Safina envoie-t-elle ?

Chaque payload de webhook contient des donnees d’appel structurees. Le contenu exact depend de l’evenement, mais les champs typiques incluent :

• Informations sur l’appelant : Nom, numero de telephone, email (si capture), entreprise
• Details de l’appel : Horodatage, duree, statut (repondu, manque, rejete)
• Resume : Motif de l’appel en 2-3 phrases, structure
• Urgence : Haute, moyenne, basse
• Actions a entreprendre : Prochaines etapes concretes issues de la conversation
• Champs specifiques au secteur : Numero de bien, domaine juridique, identifiant client selon votre modele

Exemple de payload

{
  "event": "call.ended",
  "timestamp": "2026-01-28T14:32:00Z",
  "call": {
    "id": "call_abc123",
    "status": "completed",
    "duration_seconds": 142,
    "caller": {
      "phone": "+14155551234",
      "name": "James Mitchell",
      "company": "Mitchell & Associates"
    },
    "summary": "Inquiry about network installation for new office. 18 workstations, fiber connection available. Quote requested by end of week.",
    "urgency": "medium",
    "action_items": [
      "Prepare quote for network installation",
      "Call back by Friday"
    ],
    "callback_requested": true,
    "callback_time": "mornings"
  }
}

Evenements pris en charge

Safina envoie des webhooks pour les evenements suivants :

Vous choisissez les evenements auxquels chaque webhook s’abonne. Vous n’avez besoin que de call.ended ? Abonnez-vous a celui-la. Vous voulez aussi savoir quand un appel arrive ? Ajoutez call.received.

Authentification

La securite est essentielle, surtout lorsque des donnees d’appels sont transmises. Safina prend en charge trois methodes d’authentification pour les webhooks :

Vous pouvez egalement definir des en-tetes HTTP personnalises si votre systeme a des exigences specifiques.

Configuration en 5 etapes

1. Creez un webhook

Ouvrez l’application Safina et accedez a Parametres > Webhooks > Nouveau webhook.

2. Saisissez votre URL

Entrez l’URL ou Safina doit envoyer les donnees. Il peut s’agir de votre propre serveur, d’une instance n8n, d’un webhook Zapier ou d’un scenario Make.

3. Choisissez l’authentification

Selectionnez la methode appropriee : Bearer Token, API Key ou aucune authentification. Saisissez vos identifiants.

4. Abonnez-vous aux evenements

Selectionnez les evenements qui doivent declencher le webhook. Pour la plupart des cas d’utilisation, call.ended suffit ; il vous fournit le resume complet apres chaque conversation.

5. Testez

Cliquez sur « Envoyer un test ». Safina envoie un payload de test a votre URL. Verifiez que les donnees arrivent et sont traitees correctement. N’activez le webhook qu’une fois le test reussi.

Termine. Desormais, Safina envoie automatiquement les donnees d’appels a votre systeme chaque fois qu’un evenement correspondant se produit.

Details techniques

• Methodes HTTP : POST (par defaut), GET, PUT, PATCH, DELETE
• Logique de relance : 3 tentatives automatiques en cas d’echec
• Timeout : 30 secondes (configurable)
• En-tetes personnalises : Tous les en-tetes HTTP supplementaires sont pris en charge
• Format : JSON

Cas d’utilisation

Transmettez les donnees d’appels a votre CRM

Chaque appel est automatiquement consigne comme activite dans HubSpot ou Pipedrive. Coordonnees, motif de l’appel et prochaines etapes atterrissent directement dans la fiche du contact ou de l’affaire. Aucune saisie manuelle de donnees.

Informez votre equipe sur Slack

Les appels urgents declenchent un message Slack. Votre equipe voit immediatement qui a appele et ce dont il a besoin, sans ouvrir l’application Safina.

Consignez les appels dans Google Sheets

Chaque appel est automatiquement ajoute comme nouvelle ligne dans un tableur. Date, appelant, motif, urgence, le tout trie et filtrable. Ideal pour le reporting et l’analyse.

Construisez des automatisations personnalisees

Via des plateformes de webhooks comme Zapier, Make ou n8n, vous pouvez connecter Safina a plus de 5 000 applications. Emails de suivi automatiques, entrees de calendrier, creation de tickets, le tout sans code.

Questions frequentes

A quels evenements puis-je m’abonner ?

Safina prend actuellement en charge cinq evenements : call.received, call.answered, call.ended, call.rejected et summary.data_query_result. Vous pouvez combiner librement les evenements qui declenchent une notification pour chaque webhook.

Quelles methodes d’authentification sont prises en charge ?

Trois methodes : Bearer Token (dans l’en-tete Authorization), API Key (dans l’en-tete ou le corps) et aucune authentification. Vous pouvez egalement definir des en-tetes personnalises si votre systeme recepteur l’exige.

Puis-je filtrer les evenements ?

Oui. Lors de la creation d’un webhook, vous selectionnez exactement les evenements que vous souhaitez recevoir. Vous pouvez aussi creer plusieurs webhooks avec des abonnements differents (par exemple, un pour votre CRM qui ne recoit que call.ended et un pour Slack qui recoit egalement call.received).

Que se passe-t-il si mon serveur est injoignable ?

Safina relance automatiquement la livraison jusqu’a 3 fois. Si toutes les tentatives echouent, le webhook est marque comme echoue. Vous pouvez voir le statut dans l’application et declencher manuellement un renvoi.

Puis-je tester les webhooks sans passer de vrais appels ?

Oui. Safina inclut une fonctionnalite de test integree. Vous pouvez envoyer un payload de test a votre URL a tout moment pour verifier que la connexion fonctionne et que votre systeme traite correctement les donnees.

Dans quel format les donnees sont-elles envoyees ?

JSON. Le payload est structure et documente. Chaque evenement possede un schema defini, ce qui vous permet d’analyser les donnees de maniere fiable.