Création
Créez et envoyez des messages à vos clients ou aux personnes intéressées par votre page Facebook.
Avant de commencer
Vous aurez besoin :
d’un token d’accès de Page demandé par une personne pouvant s’occuper de la tâche MESSAGE
sur la page ;
d’une autorisation pages_messaging
;
d’un message du destinataire, reçu sur votre page il y a moins de 24 heures ou de l’autorisation du destinataire pour que vous lui envoyiez des messages depuis votre page en dehors de la fenêtre d’envoi de messages standard de 24 heures.
Limites
Notez que l’API Send n’inclut pas de recipient_id
en réponse aux messages envoyés utilisant recipient.user_ref
ou recipient.phone_number
pour identifier le destinataire du message.
Exemple de demande
Pour envoyer un message à quelqu’un, envoyez une demande de POST
au point de terminaison /PAGE-ID/messsages
, reprenant le messaging_type
et l’ensemble des paramètres du recipient
, ainsi que le contenu du message.
Formaté pour la lisibilité.L’exemple qui suit est une réponse à un message, lorsque le message envoyé par votre page ne contient que du texte.
curl -i -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages
?recipient={'id':'PSID'}
&messaging_type=RESPONSE
&message={'text':'hello,world'}
&access_token=PAGE-ACCESS-TOKEN
En cas de succès, votre application recevra la réponse JSON suivante :
{
"recipient_id": "PAGE-SCOPED-ID",
"message_id": "AG5Hz2U..."
}
Paramètres
Paramètre | Description | message objet | Le type de message envoyé par votre page, que ce soit du text ou une attachement , doit être défini lors de l’utilisation de ce paramètre. |
messaging_type énumérationObligatoire | Le type de message envoyé. RESPONSE – Message en réponse à un message reçu. Cela inclut les messages promotionnels et non promotionnels envoyés pendant la fenêtre de messagerie standard de 24 heures. Par exemple, utilisez cette balise pour répondre si une personne demande une confirmation de réservation ou une mise à jour de statut.
|
notification_type énumération | Type de notification push qu’une personne reçoit. NO_PUSH – Pas de notification
REGULAR (par défaut) – Son ou vibration lorsque la personne reçoit un message
SILENT_PUSH – Notification à l’écran uniquement
|
recipient objetObligatoire | La personne qui recevra le message envoyé par votre page id – L’identifiant de la personne qui envoie un message en réponse à un message reçu sur votre page au cours des dernières 24 heures ou à une personne qui a accepté de recevoir des messages de votre page en dehors de la fenêtre d’envoi de messages standard de 24 heures.
user_ref – La référence de la personne qui envoie un message en réponse à une case à cocher ou à un plugin de discussion clientèle
comment_id – L’identifiant du commentaire permettant d’envoyer un message privé en réponse au commentaire d’un visiteur sur une publication de votre Page
post_id – L’identifiant de la publication de votre Page permettant d’envoyer un message privé en réponse à la publication d’un visiteur sur votre Page
|
sender_action énumération | L’icône d’action affichée dans la fenêtre de messagerie représentant l’action entreprise par la page à la suite d’un message reçu. typing_on – Affiche la bulle de saisie lorsque la page prépare une réponse
typing_off – N’affiche pas la bulle de saisie
mark_seen – Affiche l’icône vu lorsque les messages ont été lus par la page
ne peut être envoyé qu’avec le paramètre recipient . Ne peut pas être envoyé avec le paramètre message , doit être envoyé comme une demande distincte. |
tag énumération | Une balise permettant à votre page d’envoyer un message en dehors de la fenêtre d’envoi de messages standard de 24 heures. ACCOUNT_UPDATE – Identifie le message que vous envoyez à votre client comme une mise à jour non récurrente de leur application ou de leur compte. Consulter les utilisations autorisées. Indisponible pour l’API de messagerie Instagram. CONFIRMED_EVENT_UPDATE – Identifie le message que vous envoyez à votre client comme un rappel pour un évènement à venir ou comme une mise à jour d’un évènement en cours auquel il s’est inscrit. Consulter les utilisations autorisées. Indisponible pour l’API de messagerie Instagram. HUMAN_AGENT – Obligatoire pour l’API de messagerie Instagram. Lorsque cette balise est ajoutée à un message envoyé, cela permet à un agent humain de répondre au message. Les messages peuvent être envoyés dans les sept jours suivant le message d’un client. L’assistance avec un agent humain permet de résoudre des problèmes ne pouvant pas l’être grâce à la fenêtre de messagerie standard. Consulter les utilisations autorisées. L’autorisation Human Agent n’est pas disponible pour l’accès standard et le mode développement. Vous devrez terminer la procédure d’évaluation de l’application avant de pouvoir utiliser la balise agent humain. Lors de la soumission de votre évaluation de l’application, fournissez des instructions claires et une démonstration de la manière dont vous prévoyez d’utiliser la balise agent humain pour vos expériences. POST_PURCHASE_UPDATE – Identifie le message que vous envoyez à un client comme mise à jour en raison d’un achat réalisé récemment par le client. Consulter les utilisations autorisées. Indisponible pour l’API de messagerie Instagram.
|
Utilisation des balises de messages
Le tableau suivant établit la liste des types de messages pour chaque balise.
Balise de message | Utilisation | ACCOUNT_UPDATE
| Usages autorisésNotification de changement de statut d’une demande, pour une carte de crédit ou une offre d’emploi Notification d’activité suspecte, comme une alerte en cas de fraude
Usages non autorisés (liste non exhaustive)Contenu promotionnel, y compris, mais sans s’y limiter, les bons plans, les promotions, les coupons et réduction Contenu récurrent (p. ex. le relevé est prêt, la facture doit être payée, nouvelles offres d’emploi...) Invitations à tout sondage, à toute enquête ou à donner son avis par rapport à une précédente interaction sur Messenger
Indisponible pour l’API de messagerie Instagram. |
CONFIRMED_EVENT_UPDATE
| Usages autorisésRappel pour un cours, un rendez-vous ou un évènement à venir, prévu par l’utilisateur Confirmation de réservation ou de participation pour un évènement ou un rendez-vous accepté Notification pour un voyage ou un déplacement prévu par l’utilisateur, comme l’arrivée, l’annulation, le retard des bagages ou tout autre changement de statut lié à un voyage
Usages non autorisés (liste non exhaustive)Contenu promotionnel, y compris, mais sans s’y limiter, les bons plans, les promotions, les coupons et réduction Contenu lié à un évènement auquel l’utilisateur ne s’est pas inscrit (p. ex. rappels d’achat de billets pour un évènement, vente croisée pour d’autres évènements, horaires de visites, etc.) Messages liés à des évènement passés Invitations à tout sondage, à toute enquête ou à donner son avis par rapport à une précédente interaction sur Messenger
Indisponible pour l’API de messagerie Instagram. |
CUSTOMER_FEEDBACK
| Usages autorisésUsages non autorisés (liste non exhaustive)Indisponible pour l’API de messagerie Instagram. |
HUMAN_AGENT
| Usages autorisésUsages non autorisés (liste non exhaustive)Obligatoire pour l’API de messagerie Instagram. |
POST_PURCHASE_UPDATE
| Usages autorisésConfirmation d’une transaction, comme une facture ou un reçu Mise à jour du statut d’une expédition, comme un produit en transit, envoyé, livré ou retardé Mise à jour du statut nécessitant l’intervention de l’utilisateur pour une commande qu’il a passée, comme une carte de crédit refusée, des articles pré-commandés ou d’autres mises à jour nécessitant une action de la part du client
Usages non autorisés (liste non exhaustive)Contenu promotionnel, y compris, mais sans s’y limiter, les bons plans, les promotions, les coupons et réduction Messages de vente croisée ou de vente incitative concernant des produits ou des services Invitations à tout sondage, à toute enquête ou à donner son avis par rapport à une précédente interaction sur Messenger
Indisponible pour l’API de messagerie Instagram. |