Prises de contact

Les prises de contact sont des questions fréquentes permettant aux utilisateurs et utilisatrices d’entamer une conversation avec une entreprise. Vous pouvez définir jusqu’à quatre questions avec l’API Ice Breaker.

Depuis le 19 octobre 2021, les prises de contact prennent en charge la localisation afin que les entreprises puissent définir des questions personnalisées en fonction du paramètre régional de l’utilisateur·ice. L’API aura un nouveau format que nous encourageons les développeur·ses à utiliser pour définir et récupérer des informations sur les prises de contact. Vous trouverez la liste des paramètres régionaux pris en charge sur cette page.

Configuration des prises de contact

Nouveau format (recommandé)

curl -X POST -H "Content-Type: application/json" -d '{
     "platform": "instagram",
     "ice_breakers":[
       {
          "call_to_actions":[
             {
                "question":"

Ancien format (ne pas utiliser pour la configuration de nouvelles prises de contact)

curl -X POST -H "Content-Type: application/json" -d '{
  "platform": "instagram",
  "ice_breakers":[
     {
        "question": "

Obtention des prises de contact

Selon la manière dont la prise de contact est configurée, la requête GET renvoie une réponse dans un format différent. Le comportement suivant s’applique :

• Si la prise de contact est configurée avec l’ancien format, la requête GET renvoie une réponse dans l’ancien format.
• Si la prise de contact est configurée avec le nouveau format, la requête GET renvoie une réponse dans le nouveau format.

Nous invitons les développeur·ses à passer au nouveau format, car l’ancien format est voué à disparaître.

curl -X GET "https://graph.facebook.com/v11.0/me/messenger_profile?fields=ice_breakers&platform=instagram&access_token=<PAGE_ACCESS_TOKEN>

Réponse dans le nouveau format

{
   "data": [
        {
          "call_to_actions" : [
               {
                "question": "

Réponse dans l’ancien format

{
   "data": [
        {
          "ice_breakers": [
            {
                "question": "

Suppression des prises de contact

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "ice_breakers",
  ]
}' "https://graph.facebook.com/v11.0/me/messenger_profile?platform=instagram&access_token=%lt;PAGE_ACCESS_TOKEN>"

Évènement webhook

Afin de recevoir des webhooks de renvoi pour les prises de contact, vérifiez que l’application est abonnée au webhook messaging_postbacks versions 8.0 et ultérieures du sujet Instagram dans les paramètres de l’application.

Le webhook recevra une charge utile JSON similaire à l’exemple ci-dessous.

{
  "object": "instagram",
  "entry": [
    {
      "id": "<IGID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "<IGSID>"
          },
          "recipient": {
            "id": "<IGID>"
          },
          "timestamp": 1502905976377,
          "postback": {
            "title": "<SELECTED_ICEBREAKER_QUESTION>",
            "payload": "<USER_DEFINED_PAYLOAD>",
          }
        }
      ]
    }
  ]
}