Connecter Zapier, n8n et Make avec une clé API Safina

Crée une clé API dans l'app Safina et utilise-la dans Zapier, n8n, Make ou ton propre script : lis les appels et leurs résumés, cherche et crée des contacts, et lance un workflow après chaque appel.

Illustration au trait : une clé avec des signes de code dans une chaîne de blocs de workflow : un éclair comme déclencheur, un engrenage, une fiche contact, un combiné avec une coche verte et un ordinateur portable avec du code. Intégration
David Schemm David Schemm
Mis à jour

PrérequisExigence
Forfait SafinaPro ou Business
Ton rôle dans SafinaPropriétaire ou administrateur de l’équipe

Une clé API permet à un outil d’automatisation d’utiliser l’API REST de Safina pour ton équipe. Avec une clé, Zapier, n8n, Make ou ton propre script peuvent lire tes appels et leurs résumés, chercher et créer des contacts, et lancer un workflow après chaque appel. La clé fonctionne seulement pour l’API Safina. Les applications d’IA comme Claude ou ChatGPT se connectent d’une autre manière, décrite dans Connecter Safina à ton assistant IA.

Créer une clé API

  1. Dans l’app Safina, ouvre l’onglet Profil et touche Clés API.

Onglet Profil dans l'app Safina. Dans la section Compte, l'entrée Clés API est mise en évidence.

  1. Touche + à côté de Tes clés API. Si tu n’as encore aucune clé, touche Créer une clé API sous la liste vide.

Page Clés API avec la liste Tes clés API : une clé Zapier et une clé n8n. Le bouton + à côté du titre de la liste est mis en évidence.

  1. En haut de la page Nouvelle clé API, touche le titre et saisis un nom qui t’indique où tu utilises la clé, par exemple « Zapier ».

Page Nouvelle clé API avec le nom Zapier comme titre, mis en évidence. En dessous, le choix Que peut faire cette clé ? avec Lecture et écriture sélectionné.

  1. Sous Que peut faire cette clé ?, choisis :

    • Lecture seule : elle peut lire les appels, les contacts et les assistants.
    • Lecture et écriture : elle peut aussi créer et modifier des contacts et des webhooks.

    Tu ne peux pas changer ce choix plus tard. Pour un autre accès, crée une nouvelle clé.

  2. Sous Expire après, choisis quand la clé expire : 30 jours, 90 jours (présélectionné), 1 an ou Sans expiration.

  3. Touche Créer une clé API.

Page Nouvelle clé API avec Expire après réglé sur 90 jours. Le bouton Créer une clé API en bas est mis en évidence.

  1. La page affiche maintenant Ta nouvelle clé API. Touche Copier la clé et colle la clé dans ton automatisation. Elle commence par safina_api_. Safina n’affiche la clé complète qu’une seule fois.

Page Ta nouvelle clé API avec une clé de démonstration. Le bouton Copier la clé est mis en évidence.

  1. Touche Terminé pour revenir à la liste.

Chaque requête envoie la clé dans l’en-tête Authorization: Bearer <clé>. La liste Tes clés API montre pour chaque clé sa date de création, sa date d’expiration et sa dernière utilisation. Pour arrêter une clé tout de suite, touche la corbeille à côté d’elle et confirme avec Supprimer. Les automatisations qui l’utilisent échouent alors.

Ce qu’une clé API peut faire

DomaineLecture seuleLecture et écriture
AssistantsLister les assistants de l’équipeIdem
AppelsLister les appels (les plus récents d’abord, filtres par numéro de téléphone, date et durée) et obtenir un appel avec le résumé, l’appelant et la duréeIdem
ContactsChercher des contacts, trouver un contact par numéro de téléphoneAussi créer et modifier des contacts
Webhooks–S’abonner à l’événement call.ended et supprimer l’abonnement

Toutes les routes, tous les champs et toutes les réponses se trouvent dans la référence de l’API (en anglais).

Zapier

  • Application Safina AI pour Zapier : l’application a le déclencheur New Call, les actions Create Contact et Update Contact, et les recherches Find Call, Find Contact, Find Contact by Text et Find or Create Contact. Tu la connectes avec une clé API. L’application n’est pas encore dans le répertoire d’applications de Zapier. Pour y accéder, écris à info@safina.ai.
  • Webhooks by Zapier : un Catch Hook reçoit les données de l’appel après chaque appel, sans clé API. Les étapes sont sur Safina + Zapier.

n8n

  • Nœud Safina pour n8n : le paquet @sk-thinking/n8n-nodes-safina ajoute deux nœuds. Safina lit les assistants et les appels, et crée, trouve et met à jour des contacts. Il fonctionne aussi comme outil de l’AI Agent de n8n. Safina Trigger lance un workflow quand un appel se termine et vérifie la signature de chaque événement. Tu ajoutes la clé comme credential du type Safina API. Le nœud n’est pas encore dans la liste des community nodes de n8n. Pour y accéder, écris à info@safina.ai. Le code source est public sur GitHub.
  • Nœud HTTP Request : il appelle n’importe quelle route de l’API avec l’en-tête Authorization: Bearer <clé>.
  • Nœud Webhook : il reçoit les données de l’appel après chaque appel. Les étapes sont sur Safina + n8n.

Make

Make n’a pas encore d’application Safina. Pour appeler l’API, utilise le module HTTP Make a request avec l’en-tête Authorization: Bearer <clé>. Pour lancer un scénario après chaque appel, utilise un Custom webhook, comme décrit sur Safina + Make.

Ton propre script

L’adresse de l’API est https://api.backend.safina.ai. Cet exemple lit les cinq appels les plus récents :

curl "https://api.backend.safina.ai/calls/me?limit=5" \
  -H "Authorization: Bearer safina_api_..."

Les valeurs des paramètres de requête sont en JSON. Une valeur texte a besoin de guillemets doubles, un nombre non :

curl -G "https://api.backend.safina.ai/contacts/me" \
  --data-urlencode 'search="Miller"' \
  -H "Authorization: Bearer safina_api_..."

Un webhook après chaque appel

Avec une clé en lecture et écriture, POST /webhooks avec un name et une url crée un abonnement à l’événement call.ended. Safina envoie alors un événement par appel, dès que le résumé est prêt.

  • Mets "create_signing_secret": true pour signer les événements. La réponse contient le secret une seule fois. La vérification de l’en-tête X-Safina-Signature est expliquée dans Comment vérifier qu’un webhook vient vraiment de Safina.
  • Safina tente chaque livraison jusqu’à trois fois. Une livraison répétée a le même event_id. Ignore donc un événement que tu as déjà traité.
  • Une équipe peut avoir jusqu’à 20 webhooks. Supprime un abonnement dont tu n’as plus besoin avec DELETE /webhooks/{id}.
  • Si l’adresse répond 410 Gone à chaque tentative pour trois appels de suite, Safina désactive le webhook et envoie un e-mail. Tu peux le réactiver dans l’app sous Safina AI > Journalisation des appels > Webhooks.

Quand une requête échoue

RéponseSignification
401La clé est fausse, supprimée ou expirée : crée une nouvelle clé et mets à jour ton automatisation. Tu reçois aussi 401 si la personne qui a créé la clé n’est plus propriétaire ni administratrice de l’équipe, ou si l’équipe n’a pas de forfait actif.
403 api_keys_not_enabledTon compte n’a pas encore accès aux clés API.
403 plan_requiredL’équipe a besoin du forfait Pro ou supérieur.
403 avec une clé en lecture seuleLa requête modifie des données. Utilise une clé en lecture et écriture.
409Le numéro de téléphone appartient déjà à un contact, ou l’équipe a déjà 20 webhooks.

Questions fréquentes

Puis-je utiliser un code de connexion IA à la place d’une clé API ?

Non. Un code de connexion fonctionne seulement pour les assistants IA. Une clé API fonctionne seulement pour l’API REST.

Une clé fonctionne-t-elle pour toutes mes équipes ?

Non. Une clé appartient à l’équipe qui était active quand tu l’as créée. Pour une autre équipe, change d’équipe dans l’app et crée une clé dans cette équipe.

Que se passe-t-il quand une clé expire ?

Les requêtes avec cette clé reçoivent 401. Crée une nouvelle clé et remplace l’ancienne dans ton automatisation.

Ton équipe Safina

9:41

Safina a traité 51 appels cette semaine

46

Fiable

4

Suspect

1

Dangereux

7 derniers jours
Filter
EB
Emma Martin 67s 15:30

Souhaite discuter de l'offre pour la nouvelle campagne et a des questions sur le calendrier.

LS
Laura Dupont 54s 14:45

Demande le statut de la commande et la date de livraison.

TH
Thomas Petit 34s 13:10

Planifier une réunion pour la discussion projet la semaine prochaine.

Inconnu 44s 11:30

Promesse de gain – probablement du spam.

SM
Sophie Moreau 10s 09:15

Réclamation sur la dernière commande, demande un rappel.

MM
Michel Mercier 95s 13 déc.

Souhaite discuter d'une collaboration potentielle.

AR
Amélie Robert 85s 13 déc.

C'est votre collègue et elle souhaite discuter du projet.

JK
Julien Keller 42s 12 déc.

Se renseigne sur les créneaux disponibles la semaine prochaine.

LB
Louise Bernard 68s 12 déc.

A des questions sur la facture et demande des éclaircissements.

Appels
Safina
Contacts
Profil
9:41
Appel d'Emma Martin
12 déc.
11:30
67s
+33612345678

Souhaite discuter de l'offre pour la nouvelle campagne et a des questions sur le calendrier.

Points clés

  • Rappeler Emma Martin
  • Clarifier les questions de calendrier et de tarifs
Rappeler
Modifier le contact

Aperçus IA

Humeur de l'appelant Très bon

L'appelant était coopératif et a fourni les informations nécessaires.

Urgence Faible

L'appelant peut attendre une réponse.

Audio et transcription

0:16

Bonjour, ici Safina AI, l'assistante digitale de Peter. Comment puis-je vous aider ?

Bonjour Safina, ici Emma Martin. Je voulais discuter de l'offre et du calendrier.

Merci Emma. Hésitez-vous surtout entre le forfait Standard et le forfait Pro pour le lancement ?

Exactement. Nous avons besoin du forfait Pro et nous aimerions démarrer le mois prochain si l'onboarding est possible la première semaine.

Dites adieu à votre messagerie vocale dépassée.

Essayez Safina gratuitement et commencez à gérer vos appels intelligemment.

Safina Support Bot
Safina Support Bot

Bonjour ! 👋 Je suis l'assistant support de Safina. Pose-moi tes questions sur la configuration, le renvoi d'appel, les tarifs ou ton compte. Remarque : tes messages sont traités conformément à notre politique de confidentialité.

Tes messages sont traités conformément à notre politique de confidentialité