Obtenir un rapport avec l'API Omnisend
Renvoie des métriques agrégées de campagnes et d'automatisations, groupées par date d'envoi des messages : envois, ouvertures, clics, bounces, spam, désabonnements et commandes et revenus attribués, en totaux ou ventilés par dimensions. Limité à 10 appels par minute et 55 par jour pour la marque.
- Identifiant
- omnisend_get_report
L'appel
POST https://connect.reportei.com/api/tools/omnisend_get_report/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"queries": []
}
}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 |
|---|---|---|---|
| queries | array | Oui | From 1 to 4 queries. The response has one report per alias, each with rows that carry a key per dimension and per metric. |
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_get_report. 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.
