🟧 Zapier | PINPO Academy

Comment accéder à l'app Zapier Pinpo - V2 ?

Connectez-vous à votre compte Zapier.
Cette app est actuellement en accès sur invitation. Cliquez sur le lien d'invitation suivant : https://zapier.com/developer/public-invite/246288/11be859ddd4da412e638e9dadf646b7e/
Vous avez désormais accès à l'app PINPO - V2

Comment s'authentifier dans l'app Zapier Pinpo - V2 ?

Lors de l'ajout d'une Action ou d'un Trigger de l'app Pinpo - V2 dans votre Zap, cliquez sur Sign in (ou Connect a new account).
Renseignez votre clé API (api-key) dans le champ prévu.
Validez. Votre clé api-key a été enregistrée dan Zapier.
Votre compte apparaît dans la liste des comptes Zapier disponibles et peut être réutilisé dans n'importe quel autre Zap sans avoir à ressaisir la clé API.
ℹ️ Votre clé API se trouve dans la plateforme Pinpo, à l'emplacement suivant : Intégrations > Connexion via API key>API Key de production

⚠️ IMPORTANT
- Votre clé API est confidentielle et donne un accès direct à l'API Pinpo.
- Ne la partagez jamais publiquement et ne la communiquez qu'aux personnes autorisées à connecter votre compte à d'autres outils.

Comment importer une qualification dans l'app Zapier Pinpo - V2 (ENTRY) ?

Créez un nouveau ZAP.
Préparez la ou les étape(s) avant l'import (app Zapier d'où proviennent les informations sur les qualifications que vous allez importer dans PINPO), par exemple Facebook Lead Ads, formulaire Typeform, des étapes de transformations de données ou d'affectation à un commercial ou d'assignation à une région ...
Ajoutez une étape avec l'app Pinpo - V2.
Sélectionnez l'action event Import a qualification (ENTRY).
Cliquez sur Continuez.
Remplissez les différents champs avec les variables dynamiques des étapes précédentes OU via des valeurs "en dur".

Champ	Description	Obligatoire
Agent ID	L'identifiant de l'agent Pinpo auquel rattacher la qualification.	Oui - 💡 Vous trouverez votre Agent ID dans Pinpo, sous Intégrations > Connexion via API key > ID de l'agent.

Qualification

Champ	Description	Obligatoire
Are you sending a test qualification?	Indiquez si cette qualification doit être traitée comme une qualification de test dans Pinpo.	Oui
Qualification - ID	Identifiant externe de la qualification (si vous en gérez un dans votre système).	Non
Qualification - Source	Source de la qualification (ex. nom du formulaire, de la campagne...).	Non
Qualification CustomFields	Champs personnalisés additionnels, sous forme de paires clé/valeur (ex. `budget` → `5000`). Cliquez sur + pour ajouter autant de paires que nécessaire.	Non

Contact

Champ	Description	Obligatoire
Contact - Firstname	Prénom du contact.	Non
Contact - Lastname	Nom du contact.	Non
Contact - Gender	Genre du contact (`male`, `female`, `other`, `unknown`).	Non
Contact - Phone	Numéro de téléphone du contact.	Oui - ⚠️ Le champ Contact - Phone doit être un numéro de téléphone valide, sans quoi la création de la qualification échouera.
Contact - whatsAppUserId	Identifiant WhatsApp du contact, si disponible.	Non
Contact - Mail	Adresse email du contact.	Non
Contact - External ID	Identifiant externe du contact dans votre système.	Non

Salesperson (Commercial)

Champ	Description	Obligatoire
Salesperson - Firstname	Prénom du commercial.	Non
Salesperson - Lastname	Nom du commercial.	Non
Salesperson - Gender	Genre du commercial (`male`, `female`, `other`, `unknown`).	Non
Salesperson - Mail	Adresse email du commercial.	Non
Salesperson - Phone	Numéro de téléphone du commercial.	Non
Salesperson - External ID	Identifiant externe du commercial dans votre système.	Non
Salesperson - iCalUrl	URL du calendrier iCal du commercial.	Non

9. Cliquez sur Continue.

10. Vous pouvez soit le tester si vous disposez de données issues des étapes précédentes, soit ignorer ce test.

11. Vous pouvez désormais publier votre Zap.

ℹ️ Si une erreur survient lors de l'exécution de votre Zap, vous la retrouverez dans l'historique du Zap (History).

Comment recevoir dans Zapier un nouvel événement sur une qualification depuis l'app Zapier Pinpo - V2 (EXIT) ?

Ce trigger démarre un Zap automatiquement dès qu'un événement lié à une qualification se produit dans Pinpo. C'est le point de sortie de données de Pinpo vers Zapier.

Créez un nouveau ZAP.
Sélectionnez l'app Pinpo - V2.
Sélectionnez le trigger event New event on qualification (EXIT).
Cliquez sur Continue.
Vous allez maintenant créer un ou des souscriptions webhooks dans via l'app Pinpo - V2 dans PINPO. Remplissez le ou les agent(s) ID(s) qui doivent arriver sur ce zap (💡 Vous trouverez votre Agent ID dans Pinpo, sous Intégrations > Connexion via API key > ID de l'agent). Appuyer sur "Entrée" sur votre clavier pour les rentrer un par un.
Sélectionnez pour quel type d'événement la qualification doit arriver sur ce zap
1. Fin traitement = PINPO a clôturé la qualification.
2. Appel entrant = Le contact a appelé le numéro de téléphone utilisé par PINPO.
Cliquez sur Test.
Vous verrez l'encart suivant :
Cliquez sur Skip test
Puis terminer votre zap avec les étapes suivantes que vous désirez rajouter.

Comment gérer le ou les webhooks créé(s) (modification format / langue / suppression) ?

Tout se passe dans la plateforme PINPO. Consultez l'article Webhook pour plus d'informations.

🆘 - Questions fréquentes et dépannage

Question / Problème	Solution
Le Trigger Zapier ne reçoit plus d’événements alors que le Zap est actif.	Vérifiez que le Zap est bien activé (statut On) et que le webhook est présent et actif dans la plateforme PINPO. Consultez la documentation Webhook.
Que se passe-t-il si je supprime un webhook zapier depuis la plateforme Pinpo ?	Le Zap ne recevra plus rien.
Puis-je créer une qualification sans renseigner de contact ?	Le numéro de téléphone du contact est obligatoire. Les autres champs du contact restent facultatifs.
Que se passe-t-il si je ne renseigne pas de Custom Fields ?	Aucun champ personnalisé ne sera envoyé à Pinpo. Cela ne bloque pas la l'import de la qualification.
Puis-je utiliser les données provenant d’une étape précédente de mon Zap pour remplir les champs de l’Action ?	Oui. Tous les champs (Agent ID, Contact, Salesperson, Custom Fields, etc.) peuvent être associés dynamiquement aux données renvoyées par les étapes précédentes du Zap.
Comment savoir si ma qualification est une qualification de test ou une qualification réelle ?	Le champ Are you sending a test qualification? contrôle ce comportement. Sélectionnez No pour une qualification réelle destinée à être traitée normalement par votre agent Pinpo.