A Plataforma WhatsApp Business (API) foi projetada para empresas médias e grandes que precisam de acesso multiusuário ao WhatsApp. Ao contrário do aplicativo pessoal ou do WhatsApp Business App, ela não possui interface de mensagens incorporada. Respond.io fornece a interface de mensagens necessária para enviar e receber mensagens da WhatsApp API, além de ferramentas para enviar broadcast a grandes públicos e monitorar o desempenho de agentes e equipes.
A API do WhatsApp não é gratuita para uso e gera taxas com base no número de conversas. Saiba mais sobre Preços do WhatsApp.
Se você tem uma conta da API do WhatsApp com outro Business Solution Provider (BSP), migrar seu número de telefone para o respond.io.
Antes de começar
Prepare os seguintes pré-requisitos antes de se inscrever em uma conta da Plataforma WhatsApp Business (API):
Elegibilidade — Verifique se sua empresa se qualifica para usar o WhatsApp e revise as regras de política da Meta antes de se inscrever.
Conta do respond.io — uma conta do respond.io é necessária para acessar o fluxo de inscrição.
Número de telefone — Escolha uma das três opções:
Use seu próprio número de telefone
Use um número de telefone virtual fornecido pela Meta
Adicionar um número de telefone depois (não recomendado — veja abaixo)
Meta Business Manager (MBM) — Obrigatório para inscrição. Crie um durante o fluxo de inscrição incorporado, se necessário.
Requisitos do número de telefone
Use seu próprio número de telefone
O número deve ser válido e capaz de receber SMS ou uma chamada telefônica para verificação por OTP.
Se o número já estiver registrado no WhatsApp Personal App ou no WhatsApp Business App, você deve excluir sua conta primeiro.
O número não deve ser de nenhum destes países restritos:
Crimeia (+7978)
Cuba (+53)
Iran (+98)
Coreia do Norte (+850)
Syria (+963)
Observação: Se o número do contato for de um país restrito ou sancionado, mensagens de saída ainda podem ser entregues a esse contato. No entanto, quaisquer respostas enviadas pelo contato não serão recebidas no respond.io.
Use um número de telefone virtual fornecido pela Meta
Importante: Este número é apenas para fins de teste — não é recomendado para operações empresariais reais.
A Meta oferece números de telefone virtuais gratuitos (números comerciais 1-555) durante o cadastro. Selecione Use a display name only durante a configuração para receber um.
Benefícios:
Não é necessário comprar um novo número de telefone.
Verificado automaticamente — nenhuma verificação OTP requerida.
Conclui a integração sem configuração adicional.
Limitações:
Não pode ser usado para interações reais com clientes.
Não pode ser usado para anúncios Click-to-WhatsApp (CTWA) ou botões.
Chamadas pelo WhatsApp não são suportadas.
Não possui um nome de exibição aprovado.
Conversas iniciadas pela empresa não são permitidas sem um nome de exibição aprovado (o envio de mensagens por dia é limitado).
Não pode ser migrado para outro provedor.
Para mais detalhes, consulte a documentação da Meta.
Adicionar um número de telefone mais tarde
Importante: Esta opção não é recomendada. Selecioná-la impedirá que o canal seja conectado.
Esta opção pode aparecer se sua WhatsApp Business Account já tiver um número de telefone associado. Para completar a configuração e começar a enviar mensagens imediatamente, adicione um número de telefone durante o cadastro selecionando uma das opções abaixo:
Use a display name only — para receber um número de telefone virtual gratuito da Meta, ou
Use a new or existing WhatsApp number — para conectar seu próprio número.
Selecionar uma dessas opções garante que o Canal do WhatsApp fique totalmente configurado e pronto para enviar mensagens assim que o cadastro for concluído.
Meta Business Manager
Use um Meta Business Manager (MBM) existente ou crie um durante o processo de inscrição incorporado.
Garanta que sua empresa esteja em conformidade com a WhatsApp Business Messaging Policy.
Certifique-se de que você tem acesso Admin no seu MBM.
Certifique-se de que as Informações Comerciais do seu MBM listem um site comercial válido e publicamente acessível.
Site válido | Não é um site válido |
|---|---|
Visível e pertence ao seu negócio | Páginas pessoais do Facebook |
Possui domínio de e-mail e endereço web correspondentes | Perfis do TikTok |
Exibe o nome ou o logotipo da sua empresa | Outras páginas de redes sociais |
Importante: Um site comercial legítimo e publicamente acessível é obrigatório nas Informações Comerciais — sem ele, sua WABA pode ser desativada. Também é exigido ao solicitar a Meta Business Verification.
Conectando à Plataforma WhatsApp Business (API)
Navegue até Configurações do Workspace > Canais > clique em Adicionar canal.
Procure o cartão do Canal da Plataforma WhatsApp Business (API) no Catálogo de Canais > clique em Conectar.
Selecione seu método de conexão > clique em Começar para prosseguir com as verificações de elegibilidade.
Clique em Conectar-se com o Facebook e faça login na sua conta do Facebook.
Clique em Continuar para conceder permissões ao respond.io para gerenciar sua conta do WhatsApp Business e faturamento.
Selecione um Business portfolio da Meta e uma WhatsApp Business Account > clique em Seguinte.
Para criar um novo Business portfolio ou WhatsApp Business Account: em Business portfolio, selecione Create a business portfolio; em WhatsApp Business Account, selecione Create a WhatsApp Business account. Clique em Seguinte e siga as instruções.
Adicione seu número de telefone do WhatsApp selecionando Use a display name only para um número virtual gratuito da Meta, ou Add a new number para conectar o seu.
Verifique seu número de telefone com o código enviado por SMS ou chamada telefônica (se você selecionou Add a new number) > clique em Seguinte.
Revise o que você compartilhará com o respond.io > clique em Confirmar.
Clique em Concluir.
Importante: Se você vir Continue to feature setup em vez de Finish, sua configuração está incompleta. Vá para Meta Business Manager > WhatsApp Manager > Setup guidance para verificar o motivo. Consulte a FAQ abaixo para saber como resolver.
Seu Canal da Plataforma WhatsApp Business (API) está agora conectado ao respond.io.
Edite seu perfil — incluindo foto de perfil, endereço e descrição — a qualquer momento. Saiba mais sobre como gerenciar seu perfil na Plataforma WhatsApp Business (API).
Certifique-se de que sua moeda WABA/MBM está definida para USD. Esta etapa é crucial para evitar problemas ao enviar conversas iniciadas por negócios, mesmo quando você tiver créditos suficientes.
Enviando uma mensagem de teste
Uma vez que o Canal esteja conectado, envie uma mensagem de teste para confirmar que o envio de mensagens está funcionando.
Envie uma mensagem de teste — Use o link https://wa.me/{phoneNumber} para iniciar uma conversa com sua conta do WhatsApp Business.
Responder à mensagem de teste — Navegue até o módulo Inbox no respond.io para enviar uma resposta.
Use o WhatsApp Link Generator para gerar um link de chat para seu número de telefone.
FAQ e solução de problemas
Como removo um número da Plataforma WhatsApp Business (API) do respond.io?
Se você não deseja mais usar o respond.io como seu Business Solution Provider (BSP), siga as etapas abaixo:
Etapa 1: Excluir o canal no respond.io
Vá para Configurações do Espaço de trabalho > Canais.
Selecione o canal da sua Plataforma WhatsApp Business (API).
Exclua o canal.
Etapa 2: Remova o respond.io como parceiro na Meta (se aplicável)
Vá para Configurações do Meta Business.
Selecione Contas WhatsApp.
Abra o WhatsApp Manager.
Remova o respond.io como parceiro.
O que acontece depois que eu remover a Plataforma WhatsApp Business (API)?
O envio de mensagens pelo respond.io será interrompido imediatamente.
O histórico de mensagens existente permanece no seu Espaço de trabalho (a menos que seja excluído).
Remover o respond.io como parceiro não exclui nem rebaixa sua WABA.
Excluir um número de telefone da sua WABA pode não surtir efeito imediatamente, pois a Meta pode precisar de tempo para processar a alteração.
O que acontece se a moeda da minha WhatsApp Business Account (WABA) não for USD?
WABAs com moeda diferente de USD não são suportadas no respond.io e causarão problemas ao enviar conversas iniciadas pela empresa, mesmo que você tenha créditos suficientes.
O que você pode fazer
Migre sua WABA existente para uma nova WABA.
Se precisar de assistência, entre em contato com nossa equipe de suporte.
Nota: Criar uma nova WABA e conectá-la manualmente é possível, mas a migração é a abordagem preferida.
Por que estou vendo o erro "The WhatsApp Business (WABA) you're trying to connect already connected with another organization"?
Esse erro ocorre quando o ID da WABA já está associado a uma organização respond.io diferente. Os IDs da WABA não podem ser movidos entre organizações após a conexão.
O que você pode fazer
O número de telefone precisará ser migrado para uma nova WABA sob a nova organização. Entre em contato com nossa equipe de suporte para orientação sobre como lidar com os fundos restantes associados à WABA antiga.
Por que estou vendo “Meta Error (#133006): Phone number re-verification needed. Phone number needs to be verified before registering”?
Isso pode acontecer se a etapa de verificação OTP no fluxo de inscrição incorporado foi pulada, deixando o registro do número de telefone incompleto.
O que você pode fazer
Solicite o código de verificação na Meta.
Verifique seu número de telefone usando esse código.
Conclua a conexão do Canal.
Para mais informações, consulte a documentação da Meta sobre códigos de erro.
Por que vejo “Continue to feature setup” em vez do botão “Finish”?
Isso acontece quando seu número de telefone não foi adicionado e verificado com sucesso durante a inscrição, então sua configuração está incompleta.
Clicar em Continue to feature setup redirecionará você para a página Setup guidance. Você pode ver que Connecting phone number to respond.io aparece como incompleto.
WABA restrita: Frequentemente devido a informações comerciais incompletas ou uma restrição de ativo existente.
OTP não concluído: Isso pode acontecer se o OTP não foi recebido ou expirou.
Número conectado a uma WABA incorreta: Isso geralmente acontece com a coexistência do WhatsApp — seu número pode ainda estar vinculado à linha de crédito de um BSP anterior, o que bloqueia a nova conexão.
O que você pode fazer
Vá até WhatsApp accounts para verificar por que está incompleto:
Se sua WABA estiver restrita, envie um recurso via Meta Business Support.
Se seu OTP não foi concluído, tente reconectar seu Canal abaixo (Passo 2).
Se seu número estiver conectado a uma WABA incorreta, siga os passos para mudar para o respond.io como seu BSP.
Tente conectar novamente seu canal da Plataforma WhatsApp Business (API).
Precisa de ajuda? Entre em contato com nossa equipe de suporte.
