Experimente o Omnifox grátis 7 dias grátis. Sem cartão de crédito.
Guias

Checklist antes de conectar a API do WhatsApp: portfólio, nome e pagamento

O que ter pronto antes de conectar a API do WhatsApp: portfólio empresarial verificado, nome de exibição aprovado, método de pagamento e número limpo.

September 05, 2026
Checklist antes de conectar a API do WhatsApp: portfólio, nome e pagamento
Neste artigo

    A maior parte dos chamados de suporte sobre "conectei e não envia" tem a mesma origem: faltou algo antes de conectar a API do WhatsApp. Um portfólio empresarial recém-criado e sem verificação, um cartão que falhou na primeira cobrança, um nome de exibição rejeitado. Nenhum desses problemas é técnico, mas todos impedem o número de funcionar, e todos podiam ter sido resolvidos antes do primeiro clique.

    Este checklist antes de conectar a API do WhatsApp foi montado a partir desses casos reais. A ideia é simples: se você chega ao fluxo de conexão com tudo pronto, o número sai enviando no mesmo dia. Se chega com pendências, passa uma semana descobrindo uma de cada vez.

    Ao final há uma tabela de "sintoma → causa → solução" para quem já conectou e está vendo algo estranho.

    Os três bloqueios silenciosos mais comuns

    Antes da lista, vale entender o que costuma dar errado, porque os três casos abaixo não aparecem como erro claro na tela.

    Portfólio da Meta sem verificação. Um canal criado dentro de um portfólio empresarial (Business Portfolio, o antigo Business Manager) recém-criado e sem verificação de empresa pode simplesmente não enviar nada, ou enviar apenas para um punhado de números de teste. A conta parece conectada, os modelos até aparecem, mas as mensagens não saem. Na API isso se manifesta como erro 141010 (empresa sem verificar) ou como conta empresarial bloqueada (131031).

    Método de pagamento com falha. A Meta cobra por conversa e precisa de um cartão válido vinculado à conta do WhatsApp Business. Se a primeira cobrança falha, ou se o cartão não é aceito, a conta pode ser bloqueada até a regularização (erro 141006). Isso costuma acontecer com cartões de pessoa física com limite baixo ou com cartões corporativos que exigem aprovação interna.

    Nome de exibição sem aprovação. O nome que aparece para o cliente precisa ser aprovado pela Meta e coerente com a marca do portfólio. Enquanto não é aprovado, o número fica no nível mais baixo: 250 conversas iniciadas pela empresa por 24 horas. Muita gente conecta, vê que funciona e só descobre o teto quando a primeira campanha para na metade.

    Checklist: o que ter pronto antes de conectar

    • Portfólio empresarial verificado, com CNPJ, razão social e endereço batendo com os documentos enviados. Se o portfólio é novo, comece a verificação antes de qualquer outra coisa; ela leva tempo e nada avança sem ela.
    • Nome de exibição coerente com a marca: o nome fantasia que os clientes conhecem, sem "promoção", "oficial" ou slogans, e relacionado ao nome do portfólio ou ao site.
    • Cartão de crédito válido vinculado à conta do WhatsApp Business, com limite suficiente e sem exigência de aprovação a cada cobrança. Confira se a moeda e o país da conta estão corretos.
    • Número sem bloqueios anteriores, que não esteja em uso em outra API e, se já foi usado no app, com backup feito. Um número que já foi bloqueado permanentemente não serve.
    • Acesso ao número para receber o código por SMS ou ligação. Chips corporativos que recebem SMS em um sistema interno costumam atrasar esse passo.
    • Verificação em duas etapas (2FA): saiba o PIN atual do número se ele já está no app; você vai precisar dele durante a migração.
    • Decisão entre coexistência e migração: coexistência mantém o app do celular e importa até 6 meses de histórico; migração move o número por completo para a API (deixa de funcionar no app). Se vai precisar de chamadas de voz do WhatsApp dentro da plataforma, só o número 100 % API atende.
    • Quem é o administrador do portfólio: a pessoa que vai clicar precisa ter permissão de administrador. Um "editor" trava no meio do fluxo.
    • Site ou página pública com o nome da empresa, para a verificação e para o nome de exibição.

    Se você está em dúvida entre coexistência e migração, o artigo sobre a coexistência do WhatsApp usando o app e a API ao mesmo tempo explica o pareamento passo a passo.

    Tabela: sintoma → causa → solução

    Sintoma que você vê Causa mais provável O que fazer
    Conectou, mas nenhuma mensagem sai Portfólio sem verificação ou conta empresarial bloqueada (131031, 141010) Concluir a verificação de empresa; revisar avisos no Gerenciador do WhatsApp
    Enviava e parou de repente Cartão recusado ou cobrança pendente (141006) Atualizar o método de pagamento e aguardar a regularização
    Campanha para depois de algumas centenas de envios Nome de exibição não aprovado, nível de 250 conversas/24 h Enviar o nome para aprovação; ajustar o nome para bater com a marca
    Modelo dá erro ao enviar Parâmetro de modelo errado ou variável faltando (131009) Conferir a quantidade e o formato das variáveis do modelo
    Tudo funcionava e agora dá erro de autenticação Token expirado ou permissões alteradas (190) Reconectar o canal pelo fluxo oficial
    Mensagem para cliente antigo não chega Fora da janela de 24 horas (131047) Usar um modelo aprovado para reabrir a conversa
    Recebe, mas não consegue responder no computador Pareamento de coexistência incompleto Refazer o QR no fluxo da Meta com o celular na mão

    Para o significado de cada código, com a ação recomendada, veja erros da API do WhatsApp: 131031, 131047, 130429.

    O nome de exibição merece mais atenção do que parece

    O nome de exibição é a parte mais subestimada do checklist porque "é só um nome". Mas ele define seu nível inicial de conversas e passa por revisão humana. Regras práticas que evitam rejeição:

    1. Use o nome pelo qual a empresa é conhecida, igual ao do site, do Instagram e da fachada.
    2. Não inclua termos genéricos sozinhos ("Loja", "Atendimento", "Suporte") nem palavras como "oficial" ou "verificado".
    3. Não use nome de outra marca, mesmo que você seja revendedor autorizado.
    4. Mantenha a grafia consistente: "Padaria do Zé" e "PADARIA DO ZE" são nomes diferentes para a Meta.
    5. Se sua empresa tem várias unidades, adicione a cidade ou o bairro ("Clínica Sorriso – Moema"), desde que o portfólio tenha a marca principal.

    Um teste de fumaça antes de avisar os clientes

    Conectou? Antes de anunciar o número ou divulgar o link, faça um teste completo com um celular de fora da equipe:

    1. Envie uma mensagem do celular de teste para o número da empresa e confirme que ela aparece na caixa de entrada compartilhada.
    2. Responda pela plataforma e confira que chega no celular.
    3. Envie um modelo aprovado para o mesmo celular, com as variáveis preenchidas.
    4. Espere mais de 24 horas e envie outro modelo, para ver o comportamento fora da janela.
    5. Confira no painel de saúde do canal o estado do número, a qualidade e o nível de mensageria.

    Um modelo de utilidade simples para o teste:

    Olá, {{1}}! Aqui é a {{2}}. Seu cadastro no nosso novo canal de atendimento foi
    concluído. A partir de agora você recebe confirmações e avisos por aqui.
    Se preferir não receber, responda SAIR.
    

    Perguntas frequentes

    Preciso verificar a empresa na Meta antes de conectar a API?

    Sim, na prática sim: um portfólio sem verificação pode não enviar mensagens ou enviar apenas para números de teste. A verificação é a primeira pendência a resolver, porque leva tempo e todo o resto depende dela.

    O que acontece se meu cartão falhar na Meta?

    A conta do WhatsApp Business pode ser bloqueada até a regularização, e as mensagens param (erro 141006). Atualize o método de pagamento e aguarde a cobrança pendente ser processada.

    Sem nome de exibição aprovado eu consigo enviar?

    Consegue, mas fica limitado ao nível mais baixo, de 250 conversas iniciadas pela empresa a cada 24 horas. Responder a quem escreveu não conta nesse limite.

    Posso conectar um número que já está no app WhatsApp Business?

    Pode, de duas formas: por coexistência (continua no app e passa a funcionar na API, com importação de até 6 meses de histórico) ou por migração (deixa o app e passa a ser 100 % API). Em ambos os casos você precisa do PIN de verificação em duas etapas.

    Chegue com tudo pronto e o número sai enviando no mesmo dia

    Portfólio verificado, nome coerente, cartão válido, número limpo e a decisão entre coexistência e migração tomada: com isso resolvido, a conexão é a parte fácil. Veja como funciona a WhatsApp Business API no Omnifox e, quando estiver pronto, comece um teste grátis de 7 dias em /register.

    Pronto para testar no seu negócio?

    Reúna WhatsApp, Instagram, Messenger, e-mail e chamadas em uma só caixa de entrada e deixe a IA dar a primeira resposta. Configure hoje mesmo.

    7 dias grátis. Sem cartão de crédito.

    Comentários (0)

    Ainda não há comentários. Seja o primeiro a compartilhar.

    Deixe um comentário

    Seu email nunca é publicado. Os comentários são moderados antes de aparecer.

    Markdown suportado. HTML é removido.

    Leia mais

    Fale conosco no WhatsApp