Paramètres de /createMessage

Obsolète

/createMessage est obsolète. Les nouvelles intégrations doivent utiliser l’API de Messagerie v2 — consultez le guide de migration pour une correspondance champ par champ des paramètres ci-dessous.

Vous trouverez ici les descriptions des paramètres de l’API /createMessage.

• Les paramètres obligatoires doivent être inclus pour envoyer avec succès une requête API /createMessage et diffuser une notification push à l’heure spécifiée.

• Les paramètres optionnels vous permettent de personnaliser les propriétés des notifications push.

Note

Si vous utilisez /createMessage pour envoyer des SMS, veuillez vous référer aux Paramètres pour l’envoi de SMS. Les autres paramètres ne seront pas transmis.

Paramètres obligatoires

Les paramètres obligatoires doivent être utilisés dans les requêtes /createMessage. Sinon, la requête ne sera pas soumise.

application

Code unique d’une application créée dans votre compte Pushwoosh. Le code de l’application se trouve dans le coin supérieur gauche du Panneau de Contrôle ou en réponse à une requête /createApplication. Le code de l’application est un ensemble de 10 caractères (lettres et chiffres) séparés par des tirets.

Lors de la création d’une application via l’API, vous obtiendrez un code d’application en réponse à votre requête /createApplication.

Pour obtenir le code d’une application précédemment créée via l’API, appelez /getApplications. En réponse à la requête /getApplications, vous recevrez la liste de toutes les applications créées dans votre compte Pushwoosh avec leurs noms et codes.

auth

Jeton d’accès API depuis le Panneau de Contrôle Pushwoosh. Allez dans Paramètres → Accès API et copiez un jeton que vous souhaitez utiliser ou générez-en un nouveau.

Lors de la génération d’un jeton d’accès, spécifiez ses permissions. Cochez les cases correspondant aux types d’activités pour lesquelles vous allez utiliser le jeton API. Vous pouvez créer des jetons API spécifiques à une application en cochant les cases des Applications.

content

La chaîne de caractères ou l’objet qui définit le contenu du message. Le paramètre “content” soumis avec une valeur de type chaîne de caractères enverra le même message à tous les destinataires.

Chaîne de caractères

"content": "Hello world!",

Les objets JSON sont utilisés pour spécifier le contenu en utilisant le Contenu Dynamique, par exemple, pour les messages multilingues.

Objet

"content": {
  "en": "Hello!",
  "es": "¡Hola!",
  "de": "Hallo!"
},

notifications

Le tableau JSON des propriétés push. Doit inclure au moins les paramètres obligatoires content et send_date.

Paramètres optionnels à utiliser dans le tableau “notifications” :

• campaign
• capping_days
• capping_count
• conditions
• data
• devices
• dynamic_content
• filter
• ignore_user_timezone
• inbox_date
• inbox_image
• link
• minimize_link
• message_type
• platforms
• preset
• rich_media
• send_rate
• timezone
• template_bindings
• transactionId
• users

send_date

Date et heure auxquelles le message est envoyé. Peut être n’importe quelle date et heure formatée comme AAAA-MM-JJ HH:mm ou ‘now’. Si défini sur ‘now’, le message sera envoyé immédiatement après la soumission de la requête.

Paramètres optionnels

campaign

Le code d’une Campagne. Pour obtenir un code de Campagne, allez dans Statistiques → Statistiques agrégées et sélectionnez la Campagne que vous allez utiliser. Le code de la campagne sera visible à la fin de l’URL de la page au format XXXXX-XXXXX.

Exemple :

URL : https://app.pushwoosh.com/applications/AAAAA-AAAAA/statistics/aggregated-message?campaignCode=XXXXX-XXXXX

Code de la campagne : XXXXX-XXXXX

Pour obtenir une liste des Campagnes avec leurs codes, appelez /getCampaigns. En réponse à la requête /getCampaigns, vous recevrez la liste de toutes les Campagnes créées pour une application particulière dans votre compte Pushwoosh, avec leurs codes, noms et descriptions.

capping_days

Période à appliquer pour la limitation de fréquence, en jours (max 30 jours). Voir Limitation de fréquence pour plus de détails.

La limitation de fréquence n’est pas appliquée aux messages avec message_type: transactional. Dans tous les autres cas, la limitation de fréquence est appliquée, y compris les requêtes où message_type est omis.

capping_count

Le nombre maximum de notifications push pouvant être envoyées depuis une application spécifique à un appareil particulier pendant une période “capping_days”. Si le message créé dépasse la limite “capping_count” pour un appareil, il ne sera pas envoyé à cet appareil. Voir Limitation de fréquence pour plus de détails.

conditions

Les conditions sont des tableaux comme [tagName, operator, operand] utilisés pour envoyer des messages ciblés basés sur les Tags et leurs valeurs, où :

• tagName — le nom d’un tag à appliquer,
• opérateur — un opérateur de comparaison de valeur (“EQ” | “IN” | “NOTEQ” | “NOTIN” | “LTE” | “GTE” | “BETWEEN” | “NOTSET” | “ANY”),
• opérande — Valeurs de Tag de l’un des types suivants : chaîne de caractères | entier | tableau | date | booléen | liste

Description de l’opérateur

EQ	la valeur du tag est égale à l’opérande.
IN	la valeur du tag croise l’opérande (l’opérande doit toujours être un tableau).
NOTEQ	la valeur du tag n’est pas égale à un opérande.
NOTIN	la valeur du tag ne croise pas l’opérande (l’opérande doit toujours être un tableau).
GTE	la valeur du tag est supérieure ou égale à l’opérande.
LTE	la valeur du tag est inférieure ou égale à l’opérande.
BETWEEN	la valeur du tag est supérieure ou égale à la valeur minimale de l’opérande mais inférieure ou égale à la valeur maximale de l’opérande (l’opérande doit toujours être un tableau).
NOTSET	le tag n’est pas défini. L’opérande n’est pas pris en compte.
ANY	le tag a n’importe quelle valeur. L’opérande n’est pas pris en compte.

Tags de type chaîne de caractères

Opérateurs valides : EQ, IN, NOTEQ, NOTIN, NOTSET, ANY

Opérandes valides :

EQ, NOTEQ	l’opérande doit être une chaîne de caractères
IN, NOTIN	l’opérande doit être un tableau de chaînes de caractères comme ["valeur 1", "valeur 2", "valeur N"]
NOTSET	le tag n’est pas défini. L’opérande n’est pas pris en compte
ANY	le tag a n’importe quelle valeur. L’opérande n’est pas pris en compte

Tags de type entier

Opérateurs valides : EQ, IN, NOTEQ, NOTIN, BETWEEN, GTE, LTE, NOTSET, ANY

Opérandes valides :

EQ, NOTEQ, GTE, LTE	l’opérande doit être un entier
IN, NOTIN	l’opérande doit être un tableau d’entiers comme [valeur 1, valeur 2, valeur N]
BETWEEN	l’opérande doit être un tableau d’entiers comme [valeur_min, valeur_max]
NOTSET	le tag n’est pas défini. L’opérande n’est pas pris en compte
ANY	le tag a n’importe quelle valeur. L’opérande n’est pas pris en compte

Tags de type date

Opérateurs valides : EQ, IN, NOTEQ, NOTIN, BETWEEN, GTE, LTE, NOTSET, ANY

Opérandes valides :

• "AAAA-MM-JJ 00:00" (chaîne de caractères)
• timestamp unix 1234567890 (entier)
• "Il y a N jours" (chaîne de caractères) pour les opérateurs EQ, BETWEEN, GTE, LTE

Tags de type booléen

Opérateurs valides : EQ, NOTSET, ANY

Opérandes valides : 0, 1, true, false

Tags de type liste

Opérateurs valides : IN, NOTIN, NOTSET, ANY

Opérandes valides : l’opérande doit être un tableau de chaînes de caractères comme ["valeur 1", "valeur 2", "valeur N"].

Important

N’oubliez pas que les paramètres “filter” et “conditions” ne doivent pas être utilisés ensemble.
De plus, ils seront tous les deux ignorés si le paramètre “devices” est utilisé dans la même requête.

Tags de pays et de langue

La valeur du tag de langue est un code de deux lettres en minuscules conformément à ISO-639-1. La valeur du tag de pays est un code de deux lettres en MAJUSCULES conformément à ISO_3166-2.

Par exemple, pour envoyer une notification push aux abonnés lusophones au Brésil, vous devrez spécifier la condition suivante : "conditions": [["Country", "EQ", "BR"],["Language", "EQ", "pt"]]

conditions_operator

Opérateur logique pour les tableaux de conditions. Valeurs possibles : AND | OR. AND est la valeur par défaut.

Si l’opérateur appliqué est AND (lorsqu’aucun opérateur n’est spécifié, ou que le paramètre ‘conditions_operator’ a la valeur ‘AND’), les appareils respectant simultanément toutes les conditions recevront la notification push.

Si l’opérateur est OR, les appareils qui respectent l’une des conditions spécifiées recevront le message.

data

Chaîne de caractères JSON ou objet JSON utilisé pour passer des données personnalisées dans la charge utile push ; est passé en tant que paramètre “u” dans la charge utile (converti en chaîne de caractères JSON).

devices

Le tableau de jetons push ou de hwids pour envoyer des notifications push ciblées. S’il est défini, le message ne sera envoyé qu’aux appareils de la liste.

dynamic_content

Espaces réservés pour le Contenu Dynamique à utiliser à la place des valeurs de Tag de l’appareil. L’exemple ci-dessous enverra le message “Hello, John!” à chaque utilisateur que vous ciblez. S’il n’est pas défini, les valeurs du Contenu Dynamique sont extraites des Tags de l’appareil.

"content": "Hello, {firstname|CapitalizeFirst}!",
"dynamic_content_placeholders": {
  "firstname": "John",
  "lastname": "Doe"
},

filter

Le nom d’un Segment exactement tel qu’il est créé dans le Panneau de Contrôle Pushwoosh ou via une requête API /createFilter. Allez à la section Audience → Segments et consultez la liste des Segments créés.

Pour obtenir la liste des Segments via l’API, appelez la méthode API /listFilters. En réponse à la requête /listFilters, vous recevrez la liste de tous les Segments créés dans votre compte Pushwoosh, avec les noms, conditions et dates d’expiration des Segments.

ignore_user_timezone

Si défini sur ‘true’, envoie le message à la date et à l’heure spécifiées dans le paramètre “send_date” selon UTC-0.

Si défini sur ‘false’, les utilisateurs recevront le message à l’heure locale spécifiée selon les paramètres de leur appareil.

inbox_date

La date jusqu’à laquelle le message doit être conservé dans la Boîte de réception des utilisateurs. Si elle n’est pas spécifiée, le message sera supprimé de la Boîte de réception le lendemain de la date d’envoi.

Note

Pour enregistrer le message dans la Boîte de réception, utilisez au moins un des paramètres ‘inbox’ : “inbox_date” ou “inbox_image”.

Attention

Le message sera supprimé de la Boîte de réception à 00:00:01 de la date spécifiée, donc la date précédente est le dernier jour où un utilisateur peut voir le message dans sa Boîte de réception.

inbox_image

L’URL de l’image personnalisée à afficher à côté du message dans la Boîte de réception.

Note

Pour enregistrer le message dans la Boîte de réception, utilisez au moins un des paramètres ‘inbox’ : “inbox_date” ou “inbox_image”.

inbox_days

La durée de vie d’un message dans la boîte de réception en jours, jusqu’à 30 jours. Après cette période, le message sera supprimé de la boîte de réception. Peut être utilisé à la place du paramètre inbox_date.

link

L’URL à ouvrir une fois qu’un utilisateur ouvre une notification push.

message_type

Spécifie le type de message push. Les valeurs disponibles sont marketing et transactional. Voir Messages marketing vs transactionnels pour plus de détails.

Ce paramètre est optionnel. S’il est omis, le message est traité comme transactionnel et livré à tout le monde, y compris le groupe de contrôle. Les messages marketing ne sont pas livrés aux membres du groupe de contrôle.

minimize_link

Raccourcisseur pour minimiser l’URL soumise dans le paramètre “link”. Veuillez noter que la taille de la charge utile des notifications push est limitée, alors envisagez de créer des URL courtes pour ne pas dépasser la limite. Valeurs disponibles : 0 — ne pas minimiser, 2 — bitly. Par défaut = 2. Le raccourcisseur d’URL Google est désactivé depuis le 30 mars 2019.

platforms

Le tableau des codes de plateforme pour n’envoyer le message qu’à des plateformes spécifiques.

Les codes de plateforme disponibles incluent : 1 — iOS, 3 — Android, 7 — Mac OS X, 8 — Windows, 9 — Amazon, 10 — Safari, 11 — Chrome, 12 — Firefox, 14 — E-mail, 17 — Huawei, 18 — SMS, et 21 — WhatsApp.

preset

Le code d’un Préréglage créé dans le Panneau de Contrôle Pushwoosh ou via l’API. Pour obtenir un code de préréglage, allez dans Contenu → Préréglages, développez le préréglage que vous allez utiliser, et copiez le Code du Préréglage depuis les détails du préréglage.

rich_media

Le code d’une page Média Riche que vous allez joindre à votre message. Pour obtenir un code, allez dans Contenu → Média Riche, ouvrez une page Média Riche que vous allez utiliser, et copiez le code depuis la barre d’URL de votre navigateur. Le code est un ensemble de 10 caractères (lettres et chiffres) séparés par des tirets.

send_rate

Limitation pour restreindre la vitesse d’envoi des notifications push. Les valeurs valides sont de 100 à 1000 notifications push/seconde.

timezone

Fuseau horaire à prendre en compte lorsque le message est envoyé à une date et une heure particulières. S’il est défini, le fuseau horaire de l’appareil est ignoré. S’il est ignoré, le message est envoyé en UTC. Voir https://php.net/manual/timezones.php pour les fuseaux horaires pris en charge.

template_bindings

Espaces réservés de modèle à utiliser dans votre modèle de contenu. Voir le guide des Modèles Liquid pour plus de détails.

transactionId

Identifiant de message unique pour éviter la duplication des messages en cas de problèmes de réseau. Vous pouvez assigner n’importe quel ID à un message créé via la requête /createMessage ou /createTargetedMessage. Conservé du côté de Pushwoosh pendant 5 minutes.

use_latest_user_device

Si défini sur true, livre une notification push par utilisateur au lieu d’une par appareil : seul l’appareil avec la plus récente Dernière Ouverture d’Application parmi les plateformes dans platforms la reçoit. Si aucun des appareils d’un utilisateur sur ces plateformes n’a cette donnée, le premier appareil correspondant la reçoit à la place, donc l’envoi n’est jamais abandonné. Les appareils sans ID utilisateur ne sont pas affectés. S’applique quelle que soit la manière dont l’audience a été ciblée — par users, filter, ou conditions. Fonctionne de la même manière que use_latest_user_device dans l’API de Messagerie v2. La valeur par défaut est false (envoyer à chaque appareil).

users

Le tableau des userIds. L’ID utilisateur est un identifiant utilisateur unique défini par une requête API /registerUser, /registerDevice, ou /registerEmail.