Connecter Zapier ou n8n

Zapier et n8n sont des outils d’automatisation. Ils peuvent transmettre à BytePhase des informations venant de presque n’importe quelle autre application. Par exemple, une nouvelle ligne dans un tableur peut devenir un prospect.

Avant de commencer

• Il vous faut un compte Zapier ou n8n. Dans Zapier, l’étape Webhooks by Zapier est une fonctionnalité payante de Zapier.
• Vous pouvez connecter cette intégration sur tous les forfaits. Pour voir les demandes, il vous faut le forfait Standard ou supérieur.
• Il est utile d’avoir quelqu’un qui a déjà créé un Zap ou un workflow n8n.

Étapes

1. Allez dans Paramètres › Intégrations. Sous Site web et formulaires, cliquez sur Connecter sur Zapier ou n8n.

2. Choisissez Enregistrement autonome ou Prospect, puis cliquez sur Suivant.

3. Copiez la Clé API et l’URL du point de terminaison. Pour Zapier, vous voyez aussi une URL de base de l’API.

   La clé API n’est affichée qu’une seule fois. Copiez-la maintenant.

   

   Ordinateur

4. Créez la connexion dans votre outil. Comment connecter à l’écran liste les étapes :

   • Zapier : dans votre Zap, ajoutez une action Webhooks by Zapier › POST. Collez l’URL du point de terminaison et ajoutez votre clé API comme indiqué à l’écran. Ou, dans Zapier, cherchez « BytePhase » et connectez-vous avec la clé API et l’URL de base de l’API.
   • n8n : ajoutez un nœud HTTP Request, cliquez sur Import cURL et collez l’exemple curl de Exemples de code.

   Les sections ci-dessous indiquent quoi choisir dans Zapier et n8n.

5. Lancez un test depuis votre outil : l’étape Test de Zapier, ou exécutez le nœud n8n. Puis cliquez sur Vérifier maintenant dans BytePhase.

   Vous voyez Envoi de test capturé.

6. Cliquez sur Suivant pour passer Associer les champs et Si le client existe déjà, puis cliquez sur Activer l’intégration.

C'est fait !

Votre Zap ou votre workflow n8n crée maintenant des prospects ou des auto-enregistrements dans BytePhase à chaque exécution.

Configurer le Zap dans Zapier

1. Dans Zapier, cliquez sur Create, puis sur Zap.

2. Choisissez comme déclencheur l’application d’où viennent vos informations. Pour Google Forms, choisissez New Form Response, pas New or Updated Form Response. Sinon, une réponse modifiée crée un second prospect.

3. Cliquez sur Test trigger pour que Zapier trouve une entrée récente. S’il ne trouve rien, remplissez vous-même votre formulaire une fois et testez de nouveau.

4. Ajoutez une action : Webhooks by Zapier, puis POST. Remplissez-la ainsi :

   • URL : l’URL du point de terminaison de BytePhase.
   • Payload Type : Json. Wrap Request In Array : No. Unflatten : Yes.
   • Headers : ajoutez X-API-Key avec votre clé API. Ajoutez aussi Content-Type et Accept, tous deux réglés sur application/json.
   • Data : reprenez la structure de l’exemple curl de Exemples de code. Vos champs vont dans data. Remplissez chaque valeur avec le sélecteur de Zapier au lieu de la taper.

5. Si vous voulez, ajoutez une étape Filter by Zapier avant l’action. Ne laissez passer une entrée que si elle a un nom et un e-mail ou un numéro de mobile. Cela bloque le spam.

6. Après avoir activé l’intégration dans BytePhase, cliquez sur Publish dans Zapier.

Configurer le workflow dans n8n

Import cURL remplit le nœud HTTP Request pour vous. Pour le remplir à la main :

1. Réglez Méthode sur POST et URL sur l’URL du point de terminaison de BytePhase.

2. Ajoutez deux en-têtes : X-API-Key avec votre clé API, et Content-Type réglé sur application/json.

3. Envoyez le corps en JSON, avec la même structure que l’exemple curl. Vos champs vont dans data.

4. Si les noms de vos champs diffèrent de ceux de BytePhase, ajoutez un nœud Set avant. Renommez-les avec les noms indiqués dans Voir les champs disponibles.

Enregistrez votre clé API dans les identifiants (credentials) de n8n au lieu de la taper dans le nœud. Ainsi, elle n’apparaît pas si vous exportez le workflow.

Ce que l’application BytePhase dans Zapier peut faire

Quand vous vous connectez via l’application BytePhase dans Zapier, une seule connexion vous donne :

• Triggers (déclencheurs : quelque chose se passe dans BytePhase) : un nouveau travail, client, prospect, paiement, travail sous-traité, ou un changement de statut d’un travail.
• Actions (BytePhase fait quelque chose) : créer un client, créer un prospect ou ajouter un auto-enregistrement.
• Rechercher : trouver un client.

Bon à savoir

• Pour voir chaque envoi et s’il a fonctionné, utilisez Voir l’activité sur la carte.
• Pour la liste complète des champs acceptés par BytePhase, cliquez sur Voir les champs disponibles à l’étape de connexion, ou consultez developers.bytephase.com.
• Si votre clé API a fuité, utilisez Renouveler la clé sur la page d’activité. Puis mettez à jour votre Zap ou votre workflow avec la nouvelle clé.
• Si Zapier relance une étape, BytePhase peut créer un second enregistrement. C’est votre choix sous Si le client existe déjà qui empêche les doublons. Dans n8n, ajoutez un en-tête Idempotency-Key avec une valeur unique pour chaque entrée, pour qu’une relance soit ignorée.