WhatsApp Business Platform
WhatsApp Business Platform
Recursos

Como definir configurações de ligação

Updated: 23 de mar de 2026
As ligações não estão habilitadas por padrão em um número de telefone comercial
Use o POST /<PHONE_NUMBER_ID>/settings para habilitar os recursos da API de Ligações em um número de telefone comercial.
Qualificação para ligação
Para se qualificar para os recursos da API de Ligações, sua empresa precisa ter um limite de mensagens de pelo menos 2 mil conversas iniciadas pela empresa em um período contínuo de 24 horas.
Quando você testa a integração da API de Ligações do WhatsApp usando números de teste públicos (PTNs) e contas de sandbox, as restrições da API de Ligações são flexibilizadas.

Visão geral

Use estes pontos de extremidade para ver e definir as configurações de ligação da API de Ligações Comerciais do WhatsApp.
Você também pode configurar o protocolo de iniciação de sessão (SIP) para sinalização de chamadas em vez de usar chamadas de ponto de extremidade da Graph API e webhooks.

Para definir/atualizar as configurações de ligação de número de telefone comercial

Use este ponto de extremidade para atualizar as configurações de ligação para um número de telefone comercial individual.
Clientes do WhatsApp com a configuração de ligação mais recente
Depois que você atualizar a configuração de ligação, os usuários do WhatsApp poderão levar até sete dias para refletir essas alterações. A maioria dos usuários atualiza muito antes. Para forçar uma atualização imediata no WhatsApp, abra a janela de conversa com a empresa e a página de informações da conversa. Independentemente do comportamento do cliente do WhatsApp, a semântica das configurações ainda é respeitada no lado do servidor.

Sintaxe da solicitação

POST /<PHONE_NUMBER_ID>/settings

Parâmetros do ponto de extremidade


Espaço reservado Descrição Exemplo de valor
<PHONE_NUMBER_ID>
Número inteiro
Obrigatório

A identificação do número de telefone comercial cujas configurações da API de Ligações estão sendo atualizadas.
106540352242922

Corpo da solicitação

{
  "calling": {
    "status": "ENABLED",
    "call_icon_visibility": "DEFAULT",
    "call_icons": {
      "restrict_to_user_countries": [
        "US",
        "BR"
      ]
    },
    "call_hours": {
      "status": "ENABLED",
      "timezone_id": "America/Manaus",
      "weekly_operating_hours": [
        {
          "day_of_week": "MONDAY",
          "open_time": "0400",
          "close_time": "1020"
        },
        {
          "day_of_week": "TUESDAY",
          "open_time": "0108",
          "close_time": "1020"
        }
      ],
      "holiday_schedule": [
        {
          "date": "2026-01-01",
          "start_time": "0000",
          "end_time": "2359"
        }
      ]
    },
    "callback_permission_status": "ENABLED",
    "sip": {
      "status": "ENABLED | DISABLED (default)",
      "servers": [
        {
          "hostname": SIP_SERVER_HOSTNAME,
          "port": SIP_SERVER_PORT,
          "request_uri_user_params": {
            "KEY1": "VALUE1",
            "KEY2": "VALUE2"
          }
        }
      ]
    },
    "audio": {
      "additional_codecs": ["PCMA", "PCMU"]
    }
  }
}

Parâmetros do corpo

Parâmetro Descrição Exemplo de valor
status
String
Opcional

Habilite ou desabilite a API de Ligações para o número de telefone comercial em questão.
“ENABLED”
“DISABLED”
call_icon_visibility
String
Opcional

Defina se o ícone do botão de ligação do WhatsApp será mostrado aos usuários enquanto eles conversam com a empresa.
call_icons
String
Opcional

Defina se o ícone do botão de ligação do WhatsApp será mostrado aos usuários durante a conversa com a empresa.
call_hours
Objeto JSON
Opcional

Permite que você especifique e acione configurações para ligações recebidas com base no seu fuso horário, no horário de funcionamento da empresa e em feriados.
Todos os valores configurados anteriormente em call_hours serão substituídos pelos valores transmitidos no corpo da solicitação desta chamada à API.
callback_permission_status
String
Opcional

Ajuste a configuração para decidir se o usuário do WhatsApp receberá um pedido de permissão para ligação após ligar para sua empresa.
Observação: o pedido de permissão para ligação é acionado após uma ligação perdida ou conectada.
“ENABLED”
“DISABLED”
sip
Objeto JSON
Opcional

Configure o sinalizador de ligação por meio do protocolo de iniciação de sinal (SIP).
Observação: quando o SIP está habilitado, não é possível usar pontos de extremidade relacionados a ligações. Além disso, você não receberá webhooks relacionados a ligações.
audio
Objeto JSON
Opcional
Defina as configurações do codec de áudio para a ligação. O Opus é o codec padrão e está sempre presente.
"audio": {
  "additional_codecs": [
    "PCMA", "PCMU"
  ]
}

Status da ligação

Quando o parâmetro status é definido como “ENABLED”, os recursos de ligação são habilitados para o número de telefone comercial. Os apps de cliente do WhatsApp renderizam o ícone de botão de ligação tanto na conversa comercial quanto no perfil da conversa comercial.
Quando o parâmetro status é definido como “DISABLED”, os recursos de ligação são desabilitados. Além disso, a conversa comercial e o perfil da conversa comercial não exibem o ícone de botão de ligação.
As atualizações de status serão aplicadas ao ícone do botão de ligação nas conversas comerciais existentes quase em tempo real quando o número de telefone comercial estiver nos contatos do usuário do WhatsApp.
Caso contrário, as atualizações são feitas em tempo real para um número limitado de usuários em conversa com a empresa e são casuais para o restante das conversas.

Visibilidade do ícone de botão de ligação

Quando os recursos da API de Ligações estão habilitados para um número comercial, você ainda pode escolher se quer mostrar o ícone do botão de ligação ou não usando o parâmetro call_icon_visibility. Observação: se você desabilitar a visibilidade do ícone do botão de ligação, não estará impedindo que um usuário do WhatsApp faça ligações não solicitadas para sua empresa.
O comportamento das opções compatíveis é o seguinte:
DEFAULT
O ícone do botão de ligação será exibido na barra de menu da conversa e na página de informações da empresa, permitindo ligações não solicitadas para a empresa por usuários do WhatsApp.
Screenshot showing call button icon displayed in WhatsApp chat
DISABLE_ALL
O ícone do botão de ligação fica oculto na barra de menu da conversa e na página de informações da empresa. Além disso, todos os outros pontos de entrada externos à conversa são desabilitados. Os consumidores não podem fazer ligações não solicitadas para a empresa.
Sua empresa ainda pode enviar mensagens interativas ou mensagens de modelo com um botão de CTA da API de Ligações.
Screenshot showing hidden call button icon in WhatsApp chat

Permissões de retorno de ligação

Para fazer uma ligação a um usuário do WhatsApp, é preciso ter permissão explícita dele. Uma forma de obter permissão para ligação é solicitá-la quando o usuário do WhatsApp liga para a empresa.
É possível configurar a interface do usuário da permissão para ligação. Assim, ela será exibida automaticamente no app do cliente do usuário do WhatsApp quando ele ligar para seu número comercial. O usuário pode alterar a seleção de permissão a qualquer momento.
Diagram showing callback permissions flow in WhatsApp

Ícones de ligação

Com a configuração call_icons, é possível especificar os países em que esses ícones devem aparecer.
"call_icons": {
  "restrict_to_user_countries": [
    "US",
    "BR"
  ]
}
Parâmetro Descrição Exemplo de valores
restrict_to_user_countries
Lista de strings
Opcional

Restrinja a visibilidade dos ícones de ligação para esses países.
OBSERVAÇÃO: por exemplo, se você restringir para os "EUA", o modelo será aplicado a todas as pessoas com um número de telefone registrado nos EUA. Essas pessoas podem estar localizadas fisicamente dentro ou fora dos EUA.
Restrição aos EUA e ao Brasil:
"restrict_to_user_countries": [
  "US",
  "BR"
]
Sem restrição:
"restrict_to_user_countries": []

Horário de atendimento

Com a configuração call_hours, é possível especificar o fuso horário, o horário de funcionamento da empresa e os feriados que serão aplicados a todas as ligações iniciadas pelo usuário.
Ao definir essa configuração, você restringe as ligações aos horários semanais disponíveis que configurar. As ligações iniciadas pelo usuário ficam indisponíveis fora do horário semanal e dos feriados que você definir.
O app do cliente do WhatsApp mostrará aos usuários a opção de conversar com a empresa ou solicitar um retorno de ligação se callback_permission_status for ENABLED. O usuário também verá o próximo horário para ligação disponível na tela de opções.
Screenshot showing call hours unavailable message in WhatsApp
"call_hours": {
  "status": "ENABLED",
  "timezone_id": "America/Manaus",
  "weekly_operating_hours": [
    {
      "day_of_week": "MONDAY",
      "open_time": "0400",
      "close_time": "1020"
    },
    {
      "day_of_week": "TUESDAY",
      "open_time": "0108",
      "close_time": "1020"
    }
  ],
  "holiday_schedule": [
    {
      "date": "2026-01-01",
      "start_time": "0000",
      "end_time": "2359"
    }
  ]
}
Parâmetro Descrição Exemplo de valores
status
String
Obrigatório

Habilite ou desabilite o horário de atendimento da empresa.
Se o horário de atendimento estiver desabilitado, a empresa será considerada aberta 24 horas por dia, 7 dias por semana.
“ENABLED”
“DISABLED”
timezone_id
String
Obrigatório

O fuso horário em que a empresa está operando.
“America/Menominee”
“Asia/Singapore”
weekly_operating_hours
Lista de objetos JSON
Obrigatório

O horário de funcionamento para cada dia da semana.
Cada entrada é um objeto JSON com três pares de chave/valor:
day_of_week — (Enumeração) [Obrigatório]
O dia da semana.
Pode conter um destes sete valores: "MONDAY", “TUESDAY”, “WEDNESDAY”, “THURSDAY”, “FRIDAY”, “SATURDAY”, “SUNDAY”
open_time
close_time — (Número inteiro) [Obrigatório]
Horários de abertura e fechamento no formato de 24 horas, por exemplo, "1130" = 11:30
  • Máximo de duas entradas permitidas por dia da semana
  • open_time deve ser anterior a close_time
  • Não são permitidas entradas sobrepostas
{
"day_of_week": "MONDAY",
"open_time": "0400",
"close_time": "1020"
},
{
"day_of_week":"TUESDAY",
"open_time": "0108",
"close_time": "1020"
}
...
holiday_schedule
String
Opcional

Uma substituição opcional para a programação semanal.
É possível especificar até 20 substituições.
Observação: se holiday_schedule não for enviada na solicitação, a holiday_schedule existente será excluída e substituída por uma programação vazia.
date – (String) [Obrigatório]
Data para a qual você deseja especificar a substituição.
Formato AAAA-MM-DD.
open_time
close_time — (Número inteiro) [Obrigatório]
Horários de abertura e fechamento no formato de 24 horas, por exemplo, "1130" = 11:30
  • Máximo de duas entradas permitidas por dia da semana
  • open_time deve ser anterior a close_time
  • Não são permitidas entradas sobrepostas
{
"date": "2026-01-01",
"start_time": "0000",
"end_time": "2359",
}
...

Codec de áudio

O Opus é o codec de áudio padrão para todas as ligações do WhatsApp. É possível habilitar codecs G.711 (PCMA/PCMU) para interoperabilidade com sistemas de telefonia legada ou portais PSTN.

Diretrizes e considerações

  • Opus é o codec recomendado. O Opus oferece uma qualidade de áudio superior com menor uso de largura de banda e é o padrão para todas as ligações do WhatsApp. Use o Opus, a menos que você tenha um requisito específico para o G.711.
  • O G.711 exige transcodificação. Quando um codec G.711 é negociado, o áudio é transcodificado entre Opus (no lado do usuário do WhatsApp) e G.711 (no lado da empresa), o que pode adicionar latência à ligação.
  • O G.711 tem uma qualidade de áudio inferior. O G.711 codifica áudio a uma taxa fixa de 64 kbps sem compressão avançada, resultando em uma fidelidade inferior em comparação ao Opus.
  • O G.711 usa mais largura de banda. O G.711 requer aproximadamente 64 kbps por direção, enquanto o Opus alcança uma qualidade comparável ou melhor com taxas de bits significativamente mais baixas.
  • Use o G.711 apenas quando necessário. O principal caso de uso é a interoperabilidade com infraestrutura de telefonia legada e gateways PSTN que não oferecem suporte ao Opus.
"audio": {
  "additional_codecs": ["PCMA", "PCMU"]
}
Parâmetro Descrição Exemplo de valores
additional_codecs
Lista de strings
Opcional

Habilite codecs de áudio adicionais. Valores compatíveis: "PCMA" (G.711 A-law), "PCMU" (G.711 µ-law). O Opus é sempre habilitado por padrão e não pode ser removido. Depois de habilitar codecs adicionais, eles podem ser selecionados durante a negociação de codec SDP de acordo com o RFC 3264.
"additional_codecs": [
  "PCMA",
  "PCMU"
]
Não são permitidos codecs adicionais:
"additional_codecs": []

Resposta de sucesso

{
  "success": true
}

Resposta de erro

Confira os problemas que podem ocorrer:
  • Erros de permissão/autorização
  • Status inválido
  • Programação inválida para call_hours
  • O feriado fornecido em call_hours é uma data anterior à atual
  • O fuso horário é inválido em call_hours
  • weekly_operating_hours em call_hours não pode estar vazio
  • O formato de data em holiday_schedule para call_hours é inválido
  • Não são permitidas mais de duas entradas na programação weekly_operating_hours em call_hours
  • Não é permitida a sobreposição da programação em call_hours

Para obter as configurações de ligação do número de telefone

Use este ponto de extremidade para verificar a configuração dos recursos da API de Ligações.
Esse ponto de extremidade pode retornar informações sobre as configurações de outros recursos da API de Nuvem.

Sintaxe da solicitação

GET /<PHONE_NUMBER_ID>/settings

Parâmetros do ponto de extremidade


Parâmetro Descrição Exemplo de valor
<PHONE_NUMBER_ID>
Número inteiro
Obrigatório

A identificação do número de telefone comercial cujas configurações da API de Ligações estão sendo obtidas.
106540352242922

Permissão do app necessária

whatsapp_business_management: é necessário ter acesso avançado para usar a API para clientes empresariais finais

Corpo da resposta

{
  "calling": {
    "status": "ENABLED",
    "call_icon_visibility": "DEFAULT",
    "callback_permission_status": "ENABLED",
    "call_hours": {
      "status": "ENABLED",
      "timezone_id": "[REDACTED]",
      "weekly_operating_hours": [
        {
          "day_of_week": "MONDAY",
          "open_time": "0400",
          "close_time": "1020"
        },
        {
          "day_of_week": "TUESDAY",
          "open_time": "0108",
          "close_time": "1020"
        }
      ],
      "holiday_schedule": [
        {
          "date": "2026-01-01",
          "start_time": "0000",
          "end_time": "2359"
        }
      ]
    },
    "sip": {
      "status": "ENABLED",
      "servers": [
        {
          "hostname": "[REDACTED]",
          "sip_user_password": "[REDACTED]"
        }
      ]
    },
    "audio": {
      "additional_codecs": ["PCMA", "PCMU"]
    }
  },
  <Other non-calling feature configuration...>
}

Inclusão da senha do usuário de SIP na resposta

Como opção, você pode incluir credenciais de usuário do SIP no corpo da resposta. Basta adicionar o parâmetro de consulta de credenciais do SIP na solicitação POST:
GET /<PHONE_NUMBER_ID>/settings?include_sip_credentials=true
A resposta será semelhante a esta:
{
  "calling": {
    ... // other calling api settings
    "sip": {
      "status": "ENABLED",
      "servers": [
        {
          "hostname": "sip.example.com",
          "sip_user_password": "{SIP_USER_PASSWORD}"
        }
      ]
    }
  }
}

Detalhes da resposta

O ponto de extremidade GET /<PHONE_NUMBER_ID>/settings retorna as configurações da API de Ligações, além de outras informações de configuração do seu número de telefone comercial do WhatsApp.

Resposta com restrições de ligação

Se a sua empresa tiver restrições aplicadas, o corpo da resposta conterá informações sobre a restrição e outras configurações da API de Ligações.
 {
   "calling": {
     ... // other calling api settings
     "restrictions": {
       "restrictions_list": [
         {
           "type": "[RESTRICTED_BUSINESS_INITIATED_CALLING|RESTRICTED_USER_INITIATED_CALLING]",
           "reason": "Business|User initiated calling capability has been temporarily disabled for this phone number due to high negative feedback from users.",
           "expiration": 1754072386
         }
       ]
     }
   }
}
Parâmetro Descrição
<restrictions>
Objeto JSON
O objeto de restrições contém estes valores: restriction_list(objeto JSON): lista de restrições aplicadas atualmente com os seguintes valores
type(string) – para a restrição de ligação, esse campo teria o valor de RESTRICTED_BUSINESS_INITIATED_CALLING ou RESTRICTED_USER_INITIATED_CALLING
reason(string) – descrição da restrição
expiration(número inteiro) – o horário UNIX de expiração da restrição no fuso horário UTC

Resposta de erro

Confira os problemas que podem ocorrer:
  • Erros de permissão/autorização

Configurações de ligação no Gerenciador do WhatsApp

Também é possível controlar as configurações de ligação por meio do Gerenciador do WhatsApp.
Para acessar os controles de ligação no Gerenciador do WhatsApp:
  1. Clique no painel Ferramentas de conta > Números de telefone
  2. Clique no ícone de engrenagem ao lado do número de telefone que você está usando para fazer a ligação
  3. Clique na aba Ligações
Screenshot of WhatsApp Manager call settings interface

Para configurar e usar sinais de ligação por meio do Protocolo de Iniciação de Sessão (SIP)

O Protocolo de Iniciação de Sessão (SIP) é um protocolo de sinalização usado para iniciar, manter, modificar e encerrar sessões de comunicação em tempo real entre dois ou mais pontos de extremidade. É possível enviar e receber sinais de ligação usando o SIP em vez dos pontos de extremidade da Graph API.

Webhooks de atualização das configurações

É possível se inscrever em um novo campo de assinatura de webhook account_settings_update para receber notificações sobre atualizações nas configurações de número de telefone.
  • Você receberá uma notificação mesmo para suas próprias atualizações
  • No momento, apenas alterações nas configurações de ligação são compatíveis. No objeto de ligação, apenas as alterações nestes campos são observadas: status, call_icon_visibility, callback_permission_status, sip.status e srtp_key_exchange_protocol.

Etapas para começar

  • Configure a assinatura de webhook e assine o campo account_settings_update.
  • O mesmo app deve estar inscrito na conta do WhatsApp Business do seu número de telefone comercial.
  • O app precisa ter permissão whatsapp_business_management para receber webhooks. Ao usar o token de acesso para o mesmo app, se você conseguir obter as configurações com sucesso, seu app também poderá receber webhooks.

Carga do webhook

{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "whatsapp-business-account-id",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "timestamp": "1671644824",
                        "type": "[phone_number_settings]",
                        "phone_number_settings": {
                            "phone_number_id": "phone-number-id",
                            "calling": {
                                "status": "ENABLED",
                                "call_icon_visibility": "DEFAULT",
                                "callback_permission_status": "ENABLED",
                                "call_hours": {
                                    "status": "ENABLED",
                                    "timezone_id": "[REDACTED]",
                                    "weekly_operating_hours": [
                                        {
                                            "day_of_week": "MONDAY",
                                            "open_time": "0400",
                                            "close_time": "1020"
                                        },
                                        {
                                            "day_of_week": "TUESDAY",
                                            "open_time": "0108",
                                            "close_time": "1020"
                                        }
                                    ],
                                    "holiday_schedule": [
                                        {
                                            "date": "2026-01-01",
                                            "start_time": "0000",
                                            "end_time": "2359"
                                        }
                                    ]
                                },
                                "sip": {
                                    "status": "ENABLED",
                                    "servers": [
                                        {
                                            "hostname": "[REDACTED]",
                                            "port": SIP_SERVER_PORT
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "field": "account_settings_update"
                }
            ]
        }
    ]
}

Valores de webhook

Espaço reservado Descrição
messaging_product
String
Sempre whatsapp por enquanto
timestamp
Número inteiro
O horário em que as configurações foram atualizadas
type
String
O tipo de alteração. No momento, apenas PHONE_NUMBER_SETTINGS
phone_number_settings
Objeto
Este campo está presente se o tipo for PHONE_NUMBER_SETTINGS. No momento, apenas o subcampo calling é compatível.
phone_number_settings.phone_number_id
String
A identificação do número de telefone, com configurações atualizadas
phone_number_settings.calling
Objeto
Ele é exibido apenas se os campos relacionados a calling forem atualizados. Caso contrário, o valor será nulo. Quando presente, a carga é a mesma que a da API de obtenção de configurações

Restrições de ligação para feedback do usuário

Se as suas ligações receberem um alto índice de feedback negativo dos usuários (por exemplo, bloqueios e denúncias), a funcionalidade de ligação iniciada pela empresa, iniciada pelo usuário ou ambas no seu número de telefone poderá ser restringida.

Aviso antecipado

Como um aviso antecipado, você receberá uma notificação quando o número de telefone comercial estiver prestes a ser pausado. Os avisos de notificações antecipadas serão comunicados pelos canais abaixo

Email

Essas mensagens são enviadas aos endereços de email de todos os usuários e administradores associados à empresa. Se você não tiver recebido a mensagem, confirme qual email foi designado como email de contato do app e verifique se ele está ativo, se pode receber novas mensagens e se não sinaliza a mensagem como lixo eletrônico ou spam.

Webhook

Um webhook será enviado no campo account_update:
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "0",
      "time": 1623862418,
      "changes": [
        {
          "field": "account_update",
          "value": {
            "phone_number": "PN",
            "event": "ACCOUNT_VIOLATION",
            "violation_info": {
               "violation_type": "[LOW_BUSINESS_INITIATED_CALLING_QUALITY|LOW_USER_INITIATED_CALLING_QUALITY]",
            }
          }
        }
      ]
    }
  ]
}
Caso a empresa ou o usuário que iniciou a ligação esteja prestes a ser pausado, você receberá um webhook para o respectivo tipo de violação. Consulte account_update para ver mais informações sobre o webhook.

Pausa na funcionalidade de ligação

Quando o feedback negativo atingir um limite, a API de Nuvem restringirá automaticamente a funcionalidade de ligação do seu número de telefone por um período de 7 dias. Durante a pausa, o número de telefone não poderá fazer o seguinte:
  • Fazer ligações iniciadas pela empresa para usuários
  • Enviar pedidos de permissão de ligação
Depois que o número de telefone for pausado, as notificações serão comunicadas por meio dos canais abaixo.
Observação: as permissões de ligação aprovadas ou recusadas pelos usuários durante a pausa permanecerão válidas.

Email

Essas mensagens são enviadas aos endereços de email de todos os usuários e administradores associados à empresa. Se você não tiver recebido a mensagem, confirme qual email foi designado como email de contato do app e verifique se ele está ativo, se pode receber novas mensagens e se não sinaliza a mensagem como lixo eletrônico ou spam.

Webhook

Um webhook será enviado no campo account_update:
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "0",
      "time": 1641848059,
      "changes": [
        {
          "field": "account_update",
          "value": {
            "phone_number": "PN",
            "event": "ACCOUNT_RESTRICTION",
            "restriction_info": [
              {
                "restriction_type": "RESTRICTED_BUSINESS_INITIATED_CALLING",
                "expiration": 1641848057
              }
            ]
          }
        }
      ]
    }
  ]
}
Consulte account_update para ver mais informações sobre o webhook.

Pausa na funcionalidade de ligação iniciada pelo usuário

Quando o feedback negativo atingir um limite, a API de Nuvem restringirá automaticamente a funcionalidade de ligação iniciada pelo usuário do seu número de telefone por um período de 7 dias. Durante a pausa, o número de telefone não poderá fazer o seguinte:
  • Receber ligações de usuários
  • Exibir o ícone de ligação
Depois que o número de telefone for pausado, as notificações serão comunicadas por meio dos canais abaixo.

Email

Essas mensagens são enviadas aos endereços de email de todos os usuários e administradores associados à empresa. Se você não tiver recebido a mensagem, confirme qual email foi designado como email de contato do app e verifique se ele está ativo, se pode receber novas mensagens e se não sinaliza a mensagem como lixo eletrônico ou spam.

Webhook

Um webhook será enviado no campo account_update:
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "0",
      "time": 1641848059,
      "changes": [
        {
          "field": "account_update",
          "value": {
            "phone_number": "PN",
            "event": "ACCOUNT_RESTRICTION",
            "restriction_info": [
              {
                "restriction_type": "RESTRICTED_USER_INITIATED_CALLING",
                "expiration": 1641848057
              }
            ]
          }
        }
      ]
    }
  ]
}
Consulte account_update para ver mais informações sobre o webhook.

Restrições de ligação para baixas taxas de ligações atendidas

Quando a ligação está habilitada no seu número de telefone comercial, você deve atender às ligações recebidas dos usuários.
Se um número considerável de ligações feitas para seu número de telefone comercial habilitado não for atendido, você receberá uma notificação e deverá fazer algo para mudar.

O que acontece se você não atende às ligações

  1. Aviso por email: você receberá uma notificação por email com opções para alterar a forma de atender às ligações recebidas.
  2. As ligações ficarão restritas no número de telefone comercial: o botão de ligação ficará oculto para os usuários.

Como mitigar a situação

Se você receber um aviso

  • Continue permitindo que os usuários façam ligações:
    • Identifique e resolva o problema que está impedindo o atendimento das ligações e verifique se você tem recursos suficientes para lidar com o volume esperado de ligações.
  • Ocultar botões de ligação para ligações iniciadas pelo usuário:
    • Para isso, fale com seu parceiro ou acesse Gerenciador do WhatsApp > Ferramentas de conta > Números de telefone > selecione Número de telefone [número de telefone do WhatsApp] > Ligações > desative a opção Exibir botões de ligação.
  • Desativar as ligações:
    • Para isso, fale com seu parceiro ou acesse Gerenciador do WhatsApp > Ferramentas de conta > Números de telefone > selecione Número de telefone [número de telefone do WhatsApp] > Ligações > desative Permitir ligações de voz.

Se o botão de ligação estiver oculto para o número de telefone comercial

  • Exibir novamente os botões de ligação:
    • Identifique e resolva o problema que está impedindo o atendimento das ligações e verifique se você tem recursos suficientes para lidar com o volume esperado de ligações.
    • Depois, mostre os botões de ligação. Para isso, trabalhe com seu parceiro ou acesse Gerenciador do WhatsApp > Ferramentas de conta > Números de telefone > selecione Número de telefone [número de telefone do WhatsApp] > Ligações e ative a opção Exibir botões de ligação.
  • Desativar as ligações:
    • Para isso, fale com seu parceiro ou acesse Gerenciador do WhatsApp > Ferramentas de conta > Números de telefone > selecione Número de telefone [número de telefone do WhatsApp] > Ligações > desative Permitir ligações de voz.

Webhooks

Webhook de aviso

[
  {
    "object": "whatsapp_business_account",
    "entry": [
      {
        "id": "0",
        "time": 1641848059,
        "changes": [
          {
            "field": "account_update",
            "value": {
              "phone_number": "16505552771",
              "event": "ACCOUNT_VIOLATION",
              "violation_info": {
                "violation_type": "USER_INITIATED_CALLS_LOW_PICKUP_RATE",
                "remediation": "Please identify and address the cause of user-initiated calls not being picked up and make sure the business is properly resourced to handle expected call volumes."
              }
            }
          }
        ]
      }
    ]
  }
]

Webhook de aplicação

[
  {
    "object": "whatsapp_business_account",
    "entry": [
      {
        "id": "0",
        "time": 1641848059,
        "changes": [
          {
            "field": "account_update",
            "value": {
              "phone_number": "16505552771",
              "event": "ACCOUNT_RESTRICTION",
              "restriction_info": [
                {
                  "restriction_type": "RESTRICTED_USER_INITIATED_CALLING_CALL_BUTTON_HIDDEN",
                  "remediation": "The call button has been hidden due to low pickup rates. Please identify and address the cause of user-initiated calls not being picked up.  Next, display the calling buttons by either working with your partner or going to WhatsApp Manager > Account tools > Phone numbers > select Phone number > Calls > toggle on Display call buttons"
                }
              ]
            }
          }
        ]
      }
    ]
  }
]
Você achou esta página útil?
Ícone de polegar para cima
Ícone de polegar para baixo