🟪 Make | PINPO Academy

Comment créer un compte Make ?

Cliquez sur ce lien : Créer un compte Make
Remplissez les informations.
Votre compte Make est désormais acessible.

Comment accéder à l’app Make Pinpo - V2 ?

Connectez-vous à votre compte Make.
Cette app est actuellement accessible sur invitation. Cliquez sur le lien d’invitation suivant : https://www.make.com/en/hq/app-invitation/0271c83b15d6d9abf39cd89369333027
Sélectionnez l’organisation Make dans laquelle vous souhaitez installer l’app, puis confirmez son installation.
Vous avez désormais accès à l’app Pinpo - V2 dans Make.

Comment s’authentifier dans l’app Make Pinpo - V2 ?

Lors de l’ajout d’un module de l’app Pinpo - V2 dans votre scénario, cliquez sur Add dans le champ Connection pour créer une nouvelle connexion.
Donnez un nom à votre connexion, par exemple Pinpo - Production.
Renseignez votre clé API (api-key) dans le champ prévu.
Cliquez sur Save.

Votre connexion est enregistrée dans Make. Elle peut être réutilisée dans les autres scénarios de la même organisation sans avoir à saisir de nouveau 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 Make Pinpo - V2 (ENTRY) ?

Créez un nouveau scénario dans Make.
Préparez le ou les modules placés avant l’import. Ils correspondent aux applications d’où proviennent les informations sur les qualifications à importer dans Pinpo : Facebook Lead Ads, Typeform, CRM, etc. Vous pouvez également ajouter des modules de transformation, d’affectation à un commercial ou d’assignation à une région.
Ajoutez un nouveau module et recherchez l’app Pinpo - V2.
Sélectionnez l'action Import a qualification via /agents/{agentId}/qualifications route (ENTRY) .
Sélectionnez une connexion Pinpo existante ou cliquez sur Add pour en créer une.
Remplissez les différents champs avec les données dynamiques issues des modules précédents ou avec des valeurs fixes.
Paramètres généraux

Champ	Description	Obligatoire
Agent ID	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
Test	Indique 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, par exemple le nom du formulaire ou de la campagne.	Non
Qualification CustomFields	Champs personnalisés additionnels sous forme de paires clé/valeur, par exemple `budget` → `5000`. Cliquez sur Add item 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 numéro doit être 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

8. Cliquez sur OK pour enregistrer la configuration du module.

9. Cliquez sur la petite disquette (bandeau - bas à gauche) pour enregistrer le scénario.

10. Passez le scénario en Actif ("ON").

11. Déclenchez ensuite le premier module en envoyant une première qualification de test afin que Make exécute le scénario de A à Z.

12. Vérifiez le résultat de l'exécution affiché au-dessus du module Pinpo - V2. En cas d’erreur, ouvrez le détail de l’exécution pour consulter le message renvoyé

13. Enregistrez votre scénario, configurez sa planification si nécessaire, puis activez-le ("ON").

💡 CONSEIL : Dans la partie Scenario settings du, nous vous conseillons de passer le "Store incomplete executions" en YES, afin de pouvoir garder dans les Incomplete executions les exécutions qui n'ont pas fonctionnées.

ℹ️ Si une erreur survient lors de l’exécution, vous pourrez ainsi la retrouver dans l’historique d’exécution du scénario Make.

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

Ce module instantané démarre automatiquement un scénario dès qu’un événement lié à une qualification se produit dans Pinpo. Il constitue le point de sortie des données de Pinpo vers Make.

Créez un nouveau scénario dans Make.
Ajoutez l’app Pinpo - V2 comme premier module du scénario.
Sélectionnez le module instantané New event on qualification (EXIT).
Cliquez sur Create a Webhook.
Donnez un nom explicite au webhook, par exemple Qualifications terminées - Agent XXX .
Sélectionnez une connexion Pinpo existante ou cliquez sur Add pour en créer une.
Renseignez le ou les Agent ID dont les événements doivent arriver dans ce scénario. 💡 Vous trouverez votre Agent ID dans Pinpo, sous Intégrations > Connexion via API key > ID de l’agent.
Sélectionnez le ou les types d’événements à recevoir :
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 Save, puis sur OK, afin d’enregistrer le webhook et la configuration du module.
Vous avez la possibilité d'envoyer un paylod JSON de test depuis la plateforme depuis la gestion des Webhooks.
Cliquez sur Run once. Make se met alors en attente d’un nouvel événement.
Ajoutez et configurez les modules suivants selon le traitement souhaité dans le scénario Make.
Enregistrez le scénario et activez-le.

💡CONSEIL : Pensez à tester le scénario avec un événement réel avant sa mise en production

Comment gérer le ou les webhooks créés (modification du format, de la langue ou suppression) ?

La gestion des webhooks s’effectue dans la plateforme Pinpo. Consultez l’article Webhook pour plus d’informations.

🆘 Questions fréquentes et dépannage

Question / Problème	Solution
Le scénario Make ne reçoit plus d’événements alors qu’il est "ON"	Vérifiez que le scénario est bien activé et que le webhook est présent et actif dans la plateforme Pinpo. Vérifiez également que le module instantané est toujours le premier module du scénario. Consultez la documentation Webhook.
Que se passe-t-il si je supprime un webhook Make depuis la plateforme Pinpo ?	Le scénario Make ne recevra plus aucun événement via ce webhook, car al souscription a été supprimée.
Puis-je créer une qualification sans renseigner de contact ?	Non. 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 CustomFields ?	Aucun champ personnalisé ne sera envoyé à Pinpo. Cela ne bloque pas l’import de la qualification.
Puis-je utiliser les données provenant d’un module précédent pour remplir les champs du module Pinpo ?	Oui. Tous les champs (Agent ID, Contact, Salesperson, Custom Fields, etc.) peuvent être associés dynamiquement aux données renvoyées par les modules précédents du scénario.
Comment savoir si ma qualification est une qualification de test ou une qualification réelle ?	Le champ Test contrôle ce comportement. Sélectionnez No pour une qualification réelle destinée à être traitée normalement par votre agent Pinpo.
Le bouton Run once reste en attente et aucune donnée n’apparaît.	Vérifiez que le webhook a bien été créé, puis déclenchez dans Pinpo un événement correspondant aux Agent ID et aux types d’événements sélectionnés.
Où consulter les erreurs d’un scénario ?	Ouvrez l’historique d’exécution du scénario, puis cliquez sur l’exécution concernée et sur le module en erreur pour afficher les données d’entrée, les données de sortie et le message d’erreur.