Paramètres de /createMessage

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 impérativement ê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 dans la 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 leurs 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 autorisations. 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 enverra le même message à tous les destinataires.

String

"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.

Object

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

notifications

Le tableau JSON des propriétés de la notification 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 en 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 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 la fréquence, en jours (max 30 jours). Voir Limitation de la fréquence pour plus de détails.

La limitation de la fréquence n’est pas appliquée aux messages avec message_type: transactional. Dans tous les autres cas, la limitation de la fréquence est appliquée, y compris pour 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 la 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,
• operator — un opérateur de comparaison de valeur (“EQ” | “IN” | “NOTEQ” | “NOTIN” | “LTE” | “GTE” | “BETWEEN” | “NOTSET” | “ANY”),
• operand — les valeurs de Tag de l’un des types suivants : chaîne | 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

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 ["value 1", "value 2", "value 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 [value 1, value 2, value N]
BETWEEN	l’opérande doit être un tableau d’entiers comme [min_value, max_value]
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)
• timestamp unix 1234567890 (entier)
• "N days ago" (chaîne) 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 ["value 1", "value 2", "value 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 à la norme ISO-639-1. La valeur du tag de pays est un code de deux lettres en MAJUSCULES conformément à la norme ISO_3166-2.

Par exemple, pour envoyer une notification push à des 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 si le paramètre ‘conditions_operator’ a la valeur ‘AND’), les appareils qui respectent 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 JSON ou objet JSON utilisé pour passer des données personnalisées dans la charge utile de la notification push ; est passé en tant que paramètre « u » dans la charge utile (converti en chaîne JSON).

devices

Le tableau des jetons push ou des HWID 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 des Tags 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 dans 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, les conditions et les 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, les utilisateurs avec PW_ControlGroup: true ne recevront pas le message.

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, donc 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 de 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 Rich Media que vous allez joindre à votre message. Pour obtenir un code, allez dans Contenu → Rich Media, ouvrez une page Rich Media 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 vont 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. Consultez 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 réseau. Vous pouvez assigner n’importe quel ID à un message créé via une requête /createMessage ou /createTargetedMessage. Stocké du côté de Pushwoosh pendant 5 minutes.

users

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