Créer un lead avec l'API Instantly
Ajoute un lead à une campagne ou à une liste de leads. Un lead ajouté à une campagne active entre dans la séquence et reçoit des emails selon le planning.
- Identifiant
- instantly_create_lead
L'appel
POST https://connect.reportei.com/api/tools/instantly_create_lead/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"campaign": "<campaign>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| campaign | string | Non | Campaign that gets the lead, by the id from List campaigns. Send it or list_id. |
| list_id | string | Non | Lead list that gets the lead, by the id from List lead lists. Send it or campaign. |
| string | Non | Email of the lead, where the campaign sends. | |
| first_name | string | Non | First name of the lead. |
| last_name | string | Non | Last name of the lead. |
| company_name | string | Non | Company of the lead. |
| job_title | string | Non | Job title of the lead. |
| phone | string | Non | Phone of the lead. |
| website | string | Non | Website of the lead. |
| personalization | string | Non | Personalized line the email copy can use for this lead. |
| custom_variables | object | Non | Extra variables of the lead, as text, number or boolean values by name, like {"industry": "Retail"}. The campaign starts accepting the same variable names for its other leads. |
| skip_if_in_workspace | boolean | Non | When true, skips the lead if its email is already anywhere in the workspace. |
| skip_if_in_campaign | boolean | Non | When true, skips the lead if it is already in a campaign. |
| skip_if_in_list | boolean | Non | When true, skips the lead if it is already in a lead list. |
Connexions possibles
Votre client connecte son compte Instantly une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/instantly_create_lead. Il devient la définition de tool de votre agent sans conversion.
Autres tools Instantly
- Lister les campagnesGETListe les campagnes du workspace avec id, nom et statut, jusqu'à limit par page. Pour la page suivante, passez next_starting_after comme starting_after, jusqu'à ce qu'il ne revienne plus.
- Obtenir une campagneGETRenvoie une campagne avec statut, planning, sequences (les étapes d'email et leurs variantes), comptes d'envoi dans email_list et options d'envoi.
- Créer une campagnePOSTCrée une campagne en brouillon, avec son planning, ses étapes d'email et ses comptes d'envoi. Ajoutez des leads avec Create lead et lancez-la avec Activate campaign.
- Mettre à jour une campagnePATCHModifie une campagne. Envoyez uniquement les champs à changer ; sequences et campaign_schedule remplacent entièrement les actuels.
- Activer une campagnePOSTDémarre une campagne en brouillon ou reprend une campagne en pause. Instantly envoie alors les étapes aux leads de la campagne, depuis les comptes de email_list, dans le planning.
- Mettre une campagne en pausePOSTMet une campagne en pause : plus aucun email ne part tant qu'Activate campaign ne la reprend pas.
- Obtenir les statistiques d'une campagneGETRenvoie, par campagne, leads, contactés, emails envoyés, ouvertures, réponses, clics sur les liens, rebonds, désinscriptions, leads terminés et opportunités, pour une campagne ou pour toutes.
- Lister les leadsPOSTListe les leads avec email, noms, entreprise, statut et statut d'intérêt, jusqu'à limit par page. Pour la page suivante, passez next_starting_after comme starting_after, jusqu'à ce qu'il ne revienne plus.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
