Créer un champ personnalisé avec l'API Manychat
Crée un champ utilisateur personnalisé dans le compte et le renvoie avec son id.
- Identifiant
- manychat_create_custom_field
L'appel
POST https://connect.reportei.com/api/tools/manychat_create_custom_field/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"caption": "<caption>",
"type": "text"
}
}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 |
|---|---|---|---|
| caption | string | Oui | Name of the field. |
| type | string | Oui | Type of the values of the field.Valeurs : text, number, date, datetime, boolean |
| description | string | Non | Description of the field. |
Connexions possibles
Votre client connecte son compte Manychat 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/manychat_create_custom_field. Il devient la définition de tool de votre agent sans conversion.
Autres tools Manychat
- Consulter un contactGETRenvoie un contact avec nom, e-mail, téléphone, WhatsApp, nom d'utilisateur Instagram, opt-ins, dernière interaction, champs personnalisés et tags.
- Consulter un contact par e-mail ou téléphoneGETRenvoie le contact avec cette adresse e-mail ou ce numéro de téléphone, avec les mêmes champs que Get subscriber. Envoyez email ou phone, pas les deux.
- Rechercher des contacts par nomGETRenvoie jusqu'à 100 contacts dont le nom complet correspond, avec les mêmes champs que Get subscriber.
- Créer un contactPOSTCrée un contact avec un e-mail, un téléphone SMS ou un téléphone WhatsApp, au moins l'un des trois, et le renvoie avec son id. Chaque canal envoyé exige son opt-in : has_opt_in_email pour l'e-mail, et has_opt_in_sms avec consent_phrase pour le téléphone.
- Mettre à jour un contactPOSTMet à jour le nom, l'e-mail, le téléphone, le genre ou les opt-ins d'un contact. Changer l'e-mail ou le téléphone exige de nouveau l'opt-in : has_opt_in_email pour l'e-mail, et has_opt_in_sms avec consent_phrase pour le téléphone.
- Lister les tagsGETListe les tags du compte avec id et nom.
- Créer un tagPOSTCrée un tag dans le compte et le renvoie avec son id.
- Appliquer un tagPOSTApplique un tag à un contact. Les automatisations du compte qui démarrent quand ce tag est appliqué s'exécutent pour le contact.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
