Rompighiaccio

I rompighiaccio consentono agli utenti di iniziare una conversazione con un'azienda con una lista di FAQ. Con l'API Ice Breaker è possibile impostare al massimo 4 domande.

A partire dal 19 ottobre 2021, i rompighiaccio supportano la localizzazione per consentire alle aziende di impostare domande personalizzate a seconda della lingua dell'utente. L'API avrà un nuovo formato e incoraggiamo gli sviluppatori a utilizzarlo per impostare e recuperare le informazioni relative ai rompighiaccio. La lista delle lingue supportate è disponibile qui.

Impostazione dei rompighiaccio

Nuovo formato (consigliato)

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

Formato precedente (non dovrebbe essere usato per la nuova configurazione dei rompighiaccio)

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

Acquisizione dei rompighiaccio

A seconda della modalità di configurazione del rompighiaccio, la richiesta GET restituirà un formato diverso. Si applica il seguente comportamento:

• Se il rompighiaccio viene configurato utilizzando il formato precedente, la richiesta GET restituirà la risposta del formato precedente.
• Se il rompighiaccio viene configurato utilizzando il nuovo formato, la richiesta GET restituirà la risposta del nuovo formato.

Incoraggiamo gli sviluppatori a effettuare la migrazione al nuovo formato perché in futuro dichiareremo obsoleto il vecchio formato.

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

Risposta del nuovo formato

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

Risposta del formato precedente

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

Eliminazione dei rompighiaccio

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

Evento del webhook

Per ricevere i Webhooks di postback dai rompighiaccio, l'app deve essere iscritta al Webhook messaging_postbacks v8.0+ nell'argomento Instagram nelle impostazioni dell'app.

Il webhook riceverà un payload json simile all'esempio sottostante.

{
  "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>",
          }
        }
      ]
    }
  ]
}