Quebra-gelos

Quebra-gelos são formas de iniciar uma conversa com uma empresa usando uma lista de perguntas frequentes. A API de Quebra-Gelo permite definir quatro perguntas no máximo.

Desde 19 de outubro de 2021, os quebra-gelos são compatíveis com a localização para permitir que as empresas definam perguntas personalizadas com base na localidade do usuário. Incentivamos os desenvolvedores a aproveitarem o novo formato da API para configurar e recuperar informações de quebra-gelos. Você pode encontrar a lista de localidades aceitas aqui.

Definição de quebra-gelos

Novo formato (recomendado)

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

Formato antigo (não deve ser usado para a nova configuração de quebra-gelo)

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

Obtenção de quebra-gelos

Dependendo de como o quebra-gelo está configurado, a solicitação GET retornará um formato diferente. O comportamento a seguir será aplicado:

• Se o quebra-gelo estiver configurado no formato antigo, a solicitação GET retornará a resposta nesse formato.
• Se o quebra-gelo estiver configurado no novo formato, a solicitação GET retornará a resposta nesse formato.

Recomendamos que os desenvolvedores façam a migração para o novo formato, já que o antigo ficará obsoleto.

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

Resposta do novo formato

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

Resposta do formato antigo

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

Exclusão de quebra-gelos

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 de webhook

Para receber webhooks de postback de quebra-gelos, é necessário assinar o webhook de messaging_postbacks 8.0 ou versões superiores, no tópico Instagram das configurações de app.

O webhook receberá uma carga JSON semelhante ao exemplo a seguir.

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