Configuração do Canal do WhatsApp Business (API)

Configurar o nome do canal WhatsApp

Um canal WhatsApp Business Platform (API) pode ser configurado com um nome de canal exclusivo.

Passo 1: Vá para Configurações do espaço de trabalho > Clique em Canais.

Passo 2: Localize o canal WhatsApp Business Platform (API) > Clique em Gerenciar.

Passo 3: Configure o nome do canal, que é usado internamente para identificar a conta.

Passo 4: Clique em Salvar alterações para atualizar a configuração do canal.

Gerir perfil para a plataforma WhatsApp Business (API)

Caso seja necessário efetuar alguma alteração ou verificar o seu perfil da plataforma WhatsApp Business (API), tal pode ser feito na plataforma respond.io.

Passo 1: Vá para Configurações do espaço de trabalho > Clique em Canais.

Passo 2: Localize o canal WhatsApp Business Platform (API) > Gerenciar > Perfil

Passo 3: Se o perfil não foi sincronizado, clique em Sincronizar perfil para obter as informações mais recentes do Perfil Comercial do WhatsApp.

Passo 4: Pode editar as seguintes informações conforme necessário:

Passo 5: Revise as informações e clique em Salvar perfil.

Metadados recebidos pelo canal

Diferentes canais fornecem diferentes conjuntos de metadados do Contacto para a plataforma respond.io. Você pode obter os seguintes dados de contato deste canal:

• Número de telefone

• ID do número de telefone

• Nome do perfil

• ID WhatsApp

Tipos de ficheiro suportados

O tipo de ficheiro suportado pelo WhatsApp e o tamanho máximo de ficheiro para o tipo são os seguintes:

• Áudio & Vídeo (16 MB)

• Documento (100 MB)

• Imagem (5 MB)

• Autocolante (100 KB)

As mensagens que não são suportadas terão uma apresentação de fallback com o texto Mensagem Não Suportada ou Carga Útil Personalizada e Tipo (se disponível). Para qualquer tipo de ficheiro não suportado ou ficheiro que exceda o tamanho máximo de ficheiro enviado através do WhatsApp Business Platform (API), o ficheiro será automaticamente transformado num link URL na plataforma respond.io. Para Payload personalizado, você pode clicar em Mostrar mais para ver o payload JSON desta mensagem. Exemplos de mensagens não suportadas pela Plataforma WhatsApp Business (API) são:
- Cartão de Contato
- Reações
- Mensagem excluída
- Enquetes
- Mensagem efêmera

Certifique-se de que o formato do ficheiro é suportado; caso contrário, o ficheiro poderá falhar o envio, mesmo estando dentro do limite de tamanho. Isto acontece quando o ficheiro não é convertido corretamente. Saiba mais sobre os tipos de mídia suportados aqui.

Formatação de texto

Pode utilizar formatação de texto ou markdown nas suas mensagens. Saiba mais em como formatar seu texto aqui.

Limites de taxa

Um limite de taxa é o número de chamadas de API que uma aplicação ou utilizador pode fazer dentro de um determinado período de tempo definido pelo canal. Saiba mais sobre os limites de taxa para este canal aqui.

Limitações

Grupos WhatsApp

As mensagens de grupo não são suportadas pela WhatsApp Business Platform (API). O Meta descontinuou o desenvolvimento desta funcionalidade.

Tipos de números não suportados

O WhatsApp não permite números VoIP, números gratuitos ou fixos. Isto inclui:

• Números Telnyx (não são mais suportados desde janeiro de 2023)

• Números Google Voice (VoIP)

Boas práticas para evitar a desativação da WABA

Para garantir a estabilidade a longo prazo da sua configuração do WhatsApp Business Platform (API) e evitar bloqueios ou interrupções inesperadas, siga estas boas práticas:

Use um Meta Business Manager (MBM) verificado e exclusivo

• Use apenas um MBM por empresa. Criar vários MBMs com o mesmo nome comercial, endereço ou site pode ser sinalizado pela Meta.

• Se um MBM anterior foi banido, evite usar os mesmos dados da empresa para criar um novo—o Meta pode bani-lo instantaneamente.

• Verifique seu MBM enviando documentos comerciais oficiais (por exemplo, licença comercial, site correspondente).

• Controle o acesso com cuidado: Conceda direitos de administrador apenas a perfis reais do Facebook com atividade consistente (publicações, amigos, etc.).

• Ative a autenticação de dois fatores (2FA) para todos os administradores.

Gerencie as contas comerciais do WhatsApp (WABAs) de forma responsável

• Se uma WABA for banida, recorra ao Suporte da Meta. Não crie uma nova enquanto o recurso estiver pendente—isso pode ser visto como tentativa de contornar a política.

• Use nomes de exibição claros e precisos. Por exemplo, "Acme Co – California" é melhor do que apenas "Acme".

• Não exclua e recrie números de telefone com frequência ("queimar" números). Em vez disso, resolva o problema relatado via Meta.

Lide corretamente com usuários do Facebook

• Os administradores devem usar contas autênticas do Facebook com histórico real.

• Evite usar contas recém-criadas ou duplicadas apenas para fins de acesso.

• Restrinja o acesso aos membros essenciais da equipe e audite regularmente os usuários do MBM.

• Aplique 2FA para reduzir o risco de acesso não autorizado.

Mantenha sua empresa alinhada entre plataformas

• Garanta que seu nome comercial, endereço, site e outros detalhes correspondam ao longo do seu MBM, WABA e Conta de Anúncios.

• Esse alinhamento aumenta a confiança da Meta e melhora suas chances de verificação.

Se sua WABA for desativada

• Não entre em pânico nem crie uma nova WABA.

• Envie um recurso via Suporte empresarial da Meta.

• Reúna e forneça a documentação necessária (por exemplo, licença comercial, comprovante de propriedade de domínio).

• Revise e corrija quaisquer violações da Política de Mensagens Comerciais da Meta.

Seguir essas boas práticas ajuda a garantir que sua configuração do WhatsApp permaneça segura, estável e em conformidade com as políticas da Meta.

Perguntas frequentes e solução de problemas

Quais são os requisitos para o número de telefone usado para se inscrever na WhatsApp Business Platform (API)?

• O número de telefone usado para a WhatsApp Business Platform (API) não pode ser usado no aplicativo WhatsApp Pessoal ou Business. Você terá que excluir a conta no aplicativo WhatsApp Pessoal ou Business antes de poder usar o número para se inscrever na WhatsApp Business Platform (API).

• Você ainda pode usar o número de telefone para outras finalidades, como chamadas e recebimento de SMS após registrá-lo na WhatsApp Business Platform.

Posso ver as estatísticas das minhas conversas da minha conta comercial do WhatsApp?

Sim, você pode monitorar suas análises de mensagens e gastos em tempo real para sua conta comercial do WhatsApp na aba Insights do seu Meta WhatsApp Manager. Leia mais aqui.

Por que vejo Contatos duplicados do mesmo canal do WhatsApp?

O WhatsApp fornece o número de telefone do Contato em um formato diferente do formato E.164 que o respond.io usa. Essa diferença faz com que Contatos de certos países sejam duplicados. Se isso ocorrer, entre em contato conosco aqui.

Como faço para que o nome da minha empresa seja exibido para meus contatos no WhatsApp em vez do número da empresa?

Contas padrão da WhatsApp Business Platform (API) exibem o número da empresa em vez do nome. Para exibir o nome da sua empresa aos Contatos mesmo que eles não tenham adicionado sua empresa à agenda, você precisará de uma Conta Comercial Oficial do WhatsApp.

Contas Comerciais Oficiais têm um selo verde ao lado do nome da empresa, e normalmente apenas empresas grandes e de alto perfil recebem esse status. Saiba mais sobre como solicitar uma Conta Comercial Oficial aqui.

O que é o Meta Product Catalog e como posso usá-lo?

O Meta Product Catalog é um recurso que permite criar um catálogo dos seus produtos e compartilhá-lo com seus clientes. Saiba mais sobre como usar o Meta Product Catalog no respond.io aqui.

Uma empresa subsidiária ou agência pode registrar uma Conta Comercial do WhatsApp em nome de outra empresa?

Sim, podem. No entanto, a Meta Business Account e as informações comerciais usadas para registrar a Conta Comercial do WhatsApp devem pertencer a uma entidade que possa ser verificada com a documentação legal relevante. Saiba mais sobre a verificação de negócios da Meta aqui.

Quantos números de telefone uma empresa pode registrar ao se inscrever na WhatsApp Business Platform (API) e como posso aumentar esse limite?

Quando uma empresa se inscreve em uma conta da WhatsApp Business Platform (API) e não está verificada, ela só pode registrar até 2 números de telefone. Empresas verificadas têm a capacidade de registrar mais números de telefone. Elas podem registrar até 20 números de telefone para um único Business Manager.

Se você estiver limitado a um número menor, como 5 números, e não conseguir registrar números adicionais, você pode enviar um ticket diretamente à Meta para solicitar o aumento do limite de números de telefone.

Etapas:

1. Clique aqui neste link para suporte direto.

2. Vá para Ask a Question > WABiz: Account & WABA > Request type > Increase Phone Number Limits

3. Forneça uma explicação do motivo pelo qual você deseja aumentar o limite de números de telefone.

4. Envie sua solicitação.

Como posso verificar o consumo de conversas do WhatsApp?

Para verificar o consumo de conversas do WhatsApp, siga estes passos:

1. Vá para o seu Meta Business Manager.

2. Clique em Settings > Business Settings > WhatsApp Accounts

3. Selecione sua WABA e clique em Settings > WhatsApp Manager.

4. Em Account tools, clique em Insight.

Por que a mensagem entra como uma mensagem não suportada com o código de erro: 131051?

Uma das possíveis razões é que contas WhatsApp API não foram projetadas para conversar com outras contas WhatsApp API. Esta é uma restrição da Meta. Observe que o código de erro: 131051 é usado para vários tipos de erros relacionados a tipos de mensagem não suportados. Se você não tiver certeza sobre esse erro, você pode entrar em contato com nosso suporte.

Por que estou recebendo uma mensagem de erro indicando "Undefined: Receiver is incapable of receiving this message" ao tentar enviar mensagens?

Esta mensagem de erro é enviada pela Meta. Aqui estão alguns passos sugeridos pela Meta para solucionar o problema:

Garanta que o Contato que recebe a mensagem:

• tenha uma conta ativa no WhatsApp.

• esteja usando a versão mais recente do WhatsApp.

• tenha aceitado os novos Termos de Serviço e Política de Privacidade.

• não esteja banido no WhatsApp nem seja de um país onde o WhatsApp é proibido.

Perdi as credenciais da minha conta do Meta Business Manager. O que devo fazer?

Para recuperar o acesso à sua conta do Meta Business Manager, você pode aprender como redefinir sua senha e recuperar seu endereço de e-mail ou número de telefone aqui.

Por que minha Conta Comercial do WhatsApp foi desativada?

Sua conta WhatsApp Business API (WABA) pode ser desativada por vários motivos. Problemas comuns incluem não conformidade com as Políticas de Comércio da Meta e listar um site inválido. Para contestar essa decisão, você deve seguir os seguintes passos:

Garanta conformidade com as Políticas de Comércio da Meta: Revise e alinhe suas práticas comerciais com as diretrizes da Meta. Isto é crucial para um recurso bem-sucedido.

Garanta que você tenha umSiteVálido: Atualize as informações da sua empresa no Meta Business Manager (MBM) para incluir um site válido e claro que mostre a natureza e os detalhes do seu negócio.

Prepare um recurso: No diálogo de recurso, explique como sua empresa usa o WhatsApp para comunicação. Destaque que:

• As mensagens são enviadas apenas para clientes que optaram por receber.

• Todas as comunicações são relevantes para o seu negócio e seguem as políticas do WhatsApp.

Saiba como solicitar uma revisão com a Meta aqui.

O que devo fazer para preparar um recurso se minha WABA for desativada?

Siga estes passos e reveja as informações principais para garantir que seu recurso esteja bem preparado. Se você estiver recorrendo através da nossa equipe de Suporte ao Cliente, certifique-se de que essas capturas de tela também sejam compartilhadas com eles.

1. Revise a qualidade da sua conta comercial: Vá para Account overview -> Clique em View my accounts

2. Verifique os detalhes comerciais: Vá para Business portfolio info

3. Recupere seu ID do MBM, ID da WABA e a classificação de qualidade do número de telefone para enviar um recurso:
- Recupere seu ID do MBM nas informações da sua empresa.

- Vá para WhatsApp accounts e recupere seu ID da WABA. Selecione a conta WhatsApp correta e clique para copiar o ID da WABA.

- Role para baixo e vá até o seu WhatsApp Manager para ver a classificação de qualidade do número de telefone.

Por que recebi este erro "Business eligibility payment issue" ao enviar uma mensagem?

Esse erro pode ocorrer quando você excluiu recentemente um Canal e tentou enviar um modelo de mensagem do WhatsApp ou iniciar uma nova conversa usando um número comercial do WhatsApp diferente. Isso ocorre devido à linha de crédito ser liberada a partir do número de telefone do seu Canal excluído e redistribuída para seus números de telefone restantes. Esse processo pode levar até 5 minutos. Recomendamos aguardar 5 minutos antes de enviar a mensagem novamente.

Esse erro ocorrerá apenas se você tiver mais de um número sob o mesmo Business Manager e esses números estiverem conectados à plataforma.

Meu número WhatsApp API conectado a uma Conta Comercial do WhatsApp (WABA) registrada no Business Suite pode se conectar diretamente ao respond.io?

Não, não é possível que seu número WhatsApp API conectado a uma Conta Comercial do WhatsApp (WABA) registrada no Business Suite se conecte diretamente ao respond.io.

Por que a foto de perfil do meu Contato não está aparecendo?

Devido às limitações do canal do WhatsApp, não podemos exibir a foto de perfil do seu Contato. O WhatsApp não fornece uma API que nos permita buscar essa informação.

O que acontece quando eu excluo meu Canal do WhatsApp?

Excluir um Canal do WhatsApp não removerá os Contatos associados nem o histórico de conversas.

O histórico de conversas está vinculado aos seus Contatos; a menos que você exclua manualmente um Contato no módulo de Contatos, tanto o Contato quanto o histórico de conversas permanecerão no workspace.

Quando você reconectar o mesmo Canal do WhatsApp e receber uma mensagem do mesmo número, o Contato será mesclado com o existente.

Por que estou vendo “Meta Error (#131057): Account in maintenance mode” no WhatsApp?

Isso acontece quando sua Conta Comercial do WhatsApp está temporariamente em modo de manutenção, geralmente durante uma atualização de throughput. Dura cerca de um minuto, e seu número voltará a funcionar automaticamente assim que a atualização for concluída.

Por que estou vendo um “Media Upload Error” ou “Media Download Error” ao enviar um modelo?

Esses erros ocorrem quando o arquivo de mídia anexado ao seu modelo não atende aos requisitos da Meta. Causas comuns incluem:

• O formato do arquivo não é suportado.

• O tipo de arquivo está incorreto.

• A mídia excede os limites de tamanho da Meta.

Esses problemas se originam no lado da Meta e estão fora do controle do respond.io. Você também pode consultar a documentação de códigos de erro da Meta para mais detalhes sobre respostas de erro específicas.

Por que meu contato não consegue ver a qual mensagem estou respondendo no WhatsApp?

Isso acontece porque mensagens do WhatsApp com mais de 30 dias são movidas para armazenamento de longo prazo pela Meta, e o contexto da mensagem respondida não está mais disponível. Como resultado, a bolha de “resposta para” não aparece em mensagens enviadas como respostas para essas mensagens mais antigas.

A WhatsApp Business Platform (API) suporta chats em grupo?

Não, ela não suporta gerenciar ou enviar mensagens para chats em grupo. A Meta descontinuou o desenvolvimento deste recurso.