Lister les comptes d'envoi avec l'API Instantly
Liste les comptes d'envoi (boîtes mail) du workspace avec email, statut et données de warmup, jusqu'à limit par page. Pour la page suivante, passez next_starting_after comme starting_after, jusqu'à ce qu'il ne revienne plus.
- Identifiant
- instantly_list_accounts
L'appel
POST https://connect.reportei.com/api/tools/instantly_list_accounts/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"search": "<search>"
}
}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 |
|---|---|---|---|
| search | string | Non | Text matched against the account email. |
| status | integer | Non | Only accounts in this status: 1 active, 2 paused, 3 paused for maintenance, -1 connection error, -2 soft bounce error, -3 sending error.Valeurs : 1, 2, 3, -1, -2, -3 |
| filter | string | Non | Only accounts that are paused, have errors, have no custom tracking domain (NO_CTD), or whose warmup is active, paused or failing (W_).Valeurs : ACC_FILTER_PAUSED, ACC_FILTER_ERROR, ACC_FILTER_NO_CTD, ACC_FILTER_W_ACTIVE, ACC_FILTER_W_PAUSED, ACC_FILTER_W_ERROR |
| limit | integer | Non | Accounts per page, up to 100. |
| starting_after | string | Non | The next_starting_after of the previous page. |
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_list_accounts. 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.
