Mettre à jour un contact avec l'API Brevo
Met à jour un contact. Seuls les champs envoyés changent : listIds ajoute le contact à des listes et unlinkListIds l'en retire.
- Identifiant
- brevo_update_contact
L'appel
POST https://connect.reportei.com/api/tools/brevo_update_contact/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"identifier": "<identifier>"
}
}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 |
|---|---|---|---|
| identifier | string | Oui | Email address or contact id of the contact. Other identifiers need identifierType. |
| identifierType | string | Non | What identifier is. Required for any identifier other than an email address or a contact id.Valeurs : email_id, contact_id, ext_id, phone_id, whatsapp_id, landline_number_id |
| attributes | object | Non | Attribute values to change, keyed by the attribute name in capital letters. To change the email address, send it as EMAIL here. |
| listIds | array | Non | Ids of the lists to add the contact to, from List contact lists. |
| unlinkListIds | array | Non | Ids of the lists, from List contact lists, to remove the contact from. |
| ext_id | string | Non | New value of your own id for the contact. |
| emailBlacklisted | boolean | Non | true blocklists the contact for emails, false allows them again. |
| smsBlacklisted | boolean | Non | true blocklists the contact for SMS, false allows them again. |
Connexions possibles
Votre client connecte son compte Brevo 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/brevo_update_contact. Il devient la définition de tool de votre agent sans conversion.
Autres tools Brevo
- Lister les contactsGETListe les contacts, du plus récent au plus ancien par défaut, avec filtre optionnel par liste, date ou attribut. La réponse contient contacts et count ; paginez avec limit et offset.
- Obtenir un contactGETRenvoie un contact avec ses attributs, ses listes et les statistiques de campagnes des 90 derniers jours.
- Créer un contactPOSTCrée un contact. Envoyez email, ou l'attribut SMS, ou ext_id. Avec updateEnabled à true, un contact existant ayant le même identifiant est mis à jour au lieu d'échouer.
- Lister les listes de contactsGETListe les listes de contacts avec id, name, folderId et abonnés uniques. La réponse contient lists et count ; paginez avec limit et offset.
- Créer une liste de contactsPOSTCrée une liste de contacts vide dans un dossier et renvoie son id.
- Lister les campagnes emailGETListe les campagnes email, de la plus récente à la plus ancienne par défaut. La réponse contient campaigns et count ; paginez avec limit et offset. Les statistiques ne reviennent que si statistics est envoyé.
- Obtenir une campagne emailGETRenvoie une campagne email avec ses réglages, ses destinataires et les statistiques de son rapport.
- Créer une campagne emailPOSTCrée une campagne email en brouillon et renvoie son id. Envoyez le contenu dans exactement un champ parmi htmlContent, htmlUrl ou templateId. Définir scheduledAt planifie l'envoi, et recipients devient alors obligatoire.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
