Envoyer un événement avec l'API Omnisend
Envoie un événement client, en créant ou mettant à jour le contact, et lance les automatisations de la marque qui écoutent le nom de l'événement. Les événements personnalisés acceptent n'importe quel nom et propriétés ; les événements recommandés, comme placed order, suivent le schema de leur page dans la documentation Omnisend.
- Identifiant
- omnisend_send_event
L'appel
POST https://connect.reportei.com/api/tools/omnisend_send_event/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"eventName": "<eventName>",
"origin": "<origin>",
"contact": {}
}
}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 |
|---|---|---|---|
| eventName | string | Oui | Name of the event, for example webinar registered, or the name of a recommended event such as placed order. |
| origin | string | Oui | Source of the event: api for a custom store, or the name of the app that sends it. |
| contact | object | Oui | Who the event belongs to, found by email, phone or id. The other fields update the contact. |
| properties | object | Non | Properties of the event, keyed by name. Automations and segments can use them. |
| eventVersion | string | Non | Only for recommended events: the version given on the page of the event in the Omnisend docs. Leave it out for custom events. |
| eventTime | string | Non | When the event happened, as RFC 3339. The default is now. |
| eventID | string | Non | Your own UUID for the event. With eventTime, it avoids processing the same past event twice. |
Connexions possibles
Votre client connecte son compte Omnisend 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/omnisend_send_event. Il devient la définition de tool de votre agent sans conversion.
Autres tools Omnisend
- Lister les contactsGETListe les contacts avec id, email, phone, status, tags, segments et propriétés personnalisées, du plus récent au plus ancien par défaut. La réponse contient contacts et paging ; tant que paging.hasMore vaut true, passez paging.cursors.after comme after et gardez les filtres.
- Créer un contactPOSTCrée un contact, ou met à jour le contact qui a déjà le même identifiant email. Mettre un canal à subscribed envoie le message de bienvenue de la marque, quand cette automatisation est active, sauf si sendWelcomeMessage vaut false.
- Modifier un contactPATCHMet à jour un contact. Seuls les champs envoyés changent, mais tags remplace toute la liste de tags : pour seulement ajouter des tags, utilisez Appliquer des tags. Un statut de canal dans identifiers abonne ou désabonne le contact.
- Appliquer des tagsPOSTAjoute des tags à des contacts, en gardant les tags qu'ils ont déjà. Choisissez les contacts par contactIDs, emails, phones ou segmentID ; les sélections s'additionnent. Limité à 60 appels par minute.
- Lister les segmentsGETListe les segments avec segmentID, name et status. Le segmentID cible les campagnes et filtre les contacts. La réponse contient segments et paging ; tant que paging.hasMore vaut true, passez paging.cursors.after comme after.
- Lister les modèles d'emailGETListe les modèles d'email avec id et name, du plus récent au plus ancien par défaut. L'id est le corps d'une campagne email. La réponse contient templates et paging ; tant que paging.hasMore vaut true, passez paging.cursors.after comme after.
- Lister les campagnesGETListe les campagnes avec id, name, status, channel, content, audience et réglages d'envoi, de la plus récente à la plus ancienne par défaut. La réponse contient campaigns et paging ; tant que paging.hasMore vaut true, passez paging.cursors.after comme after et gardez les filtres.
- Créer une campagnePOSTCrée une campagne email ou SMS classique en brouillon et la renvoie avec son id. Une campagne email a besoin de content.email.templateID, issu de Lister les modèles d'email, et une campagne SMS de content.sms. Rien n'est envoyé avant Envoyer une campagne.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
