Tools Omnisend
Les 14 opérations Omnisend que votre produit exécute sur le compte de votre client via Connect. Elles utilisent toutes le même endpoint, POST /api/tools/{tool}/execute.
- 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.
- Modifier une campagnePATCHMet à jour une campagne au statut draft. Seuls les champs envoyés changent. Le modèle d'email reste celui défini à la création. Pour modifier une campagne qui n'est plus un brouillon, l'app demande une copie.
- Envoyer un email de test de la campagnePOSTEnvoie par email un aperçu d'une campagne email en brouillon à 5 adresses au plus, avec l'objet, l'expéditeur et le contenu enregistrés. La campagne elle-même ne change pas.
- Envoyer une campagnePOSTEnvoie une campagne au statut draft à son audience, tout de suite ou à l'heure de ses réglages d'envoi, et consomme des envois du plan. Une campagne envoyée ne peut pas être renvoyée.
- Envoyer un événementPOSTEnvoie 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.
- Obtenir un rapportPOSTRenvoie 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.
- Lister les produitsGETListe les produits du catalogue de la boutique avec id, title, status, URL, images et variantes avec prix. La réponse contient products et paging ; paginez avec offset et limit tant que paging.next est renseigné.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
