Como conectar um número na API oficial do WhatsApp em 5 minutos, sem burocracia

Resposta curta: dá para ter acesso à API oficial do WhatsApp sem criar conta de desenvolvedor, sem criar aplicativo na Meta, sem enviar nada para análise e sem esperar aprovação. Isso só é possível por uma empresa parceira da Meta, como a Datafy API. Você cria a conta no painel, clica em conectar o primeiro número, entra com o Facebook, escolhe o portfólio empresarial (a BM), diz se o número é um chip novo ou um aplicativo do WhatsApp Business que já existe, escaneia um QR code com o celular e pronto. A conexão em si leva até 45 segundos. Depois, ainda na Meta, você cadastra a forma de pagamento, que é de onde a Meta desconta as mensagens.

Principais pontos

• Sem a burocracia da Meta. Nas palavras do Israel Henrique, CTO da Datafy: "sem ter que passar por toda aquela burocracia da meta de criar uma conta developer, depois criar um aplicativo, fazer toda a configuração, enviar para uma análise da meta e esperar a aprovação deles."
• Você precisa de uma conta no Facebook. "Para você utilizar a API oficial tem que ter uma conta no Facebook, porque a API oficial justamente o número fica cadastrado lá em uma BM do Facebook."
• Duas opções de número: criar uma conta do WhatsApp Business (chip novo) ou conectar o app do WhatsApp Business que você já usa, que é a coexistência.
• A conexão é por QR code, escaneado com o celular, e termina em uma tela dizendo que a conta foi conectada à plataforma.
• Quem cobra as mensagens é a Meta, no cartão cadastrado na sua BM. Para a Datafy você paga "somente a conexão com o WhatsApp".

Antes de começar

Passo 1: criar a conta e o número no painel

Acesse datafyapi.com.br, clique em entrar e crie a sua conta. O teste é gratuito: "você pode testar a plataforma por 7 dias de graça."

Com a conta criada e nenhum número conectado ainda, a tela mostra um botão para conectar o primeiro número. Ao clicar:

1. Dê um nome para a conexão. No vídeo, o nome escolhido é "suporte". É um apelido interno, para você identificar o número depois.
2. Clique em criar número.

Você cai na página daquele número. Ela tem várias abas, mas, como ele diz, "o que importa para a gente nesse momento é somente a primeira aba de visão geral", onde fica a opção conectar ao WhatsApp.

Clique em conectar ao WhatsApp. Abre uma tela do Facebook.

Passo 2: escolher o portfólio empresarial

A primeira tela do Facebook pede o portfólio empresarial, ou seja, "a tua BM, que o pessoal geralmente chama".

• Já tem uma BM? Escolha na lista.
• Não tem? "Pode clicar aqui em criar um portfólio empresarial" e criar ali mesmo, sem sair do fluxo.

Depois de escolher o portfólio, você conecta a conta do WhatsApp.

Passo 3: chip novo ou aplicativo que já existe

Aqui aparecem duas opções, e essa é a escolha que mais confunde:

Nas palavras dele: "o que seria a coexistência que a gente fala normalmente." No vídeo, a opção escolhida é a segunda, o aplicativo que já existe.

Escolha a sua opção e clique em avançar.

Passo 4: informar o número e escanear o QR code

1. Digite o número, com o código do país e o DDD.
2. Avance. Aparece uma mensagem de confirmação, e você avança de novo.
3. Olhe o seu WhatsApp. Chega uma mensagem do Facebook. Toque em conectar dentro dessa mensagem.
4. No celular abre a tela conectar plataforma comercial. Toque em conectar.
5. O celular pergunta se você deseja compartilhar o seu histórico de conversas e mensagens. Escolha e confirme. No vídeo, ele confirma.
6. Aponte a câmera do celular para o QR code que está na tela do computador.

A partir daí é esperar: "ele vai começar agora a fazer a conexão... esse processo pode levar até 45 segundos."

No fim, o celular mostra a mensagem de que a conta foi conectada à plataforma Datafy Chats. Esse nome é o da entidade verificada da Datafy na Meta, e é por isso que ele aparece aqui, e não o nome do produto que você contratou. Toque em OK e volte para o computador.

Passo 5: terminar a configuração no computador

De volta ao navegador:

1. O nome já vem preenchido, puxado do próprio WhatsApp.
2. Escolha o fuso horário. No vídeo, São Paulo.
3. Avance e confirme. A tela mostra que está conectando a sua conta.
4. Pode aparecer um código de confirmação enviado para o e-mail da sua conta do Facebook. Isso é novo, e ele comenta ao vivo: "confesso que para mim é novo, isso daqui não tinha aparecido antes." Busque o código no e-mail, cole na tela e siga.
5. Espere. "Conectando sua conta, isso pode levar alguns instantes."
6. A mensagem de conta conectada aparece de novo, agora no computador. Clique em concluir.

A página atualiza e mostra o número conectado com sucesso. Segundo ele: "a partir desse momento, esse meu número aqui, ele já está conectado na API oficial do WhatsApp. Eu posso enviar mensagens, receber mensagens por aqui."

A tela de forma de pagamento

Na conclusão aparece a opção de adicionar uma forma de pagamento. Vale ler a frase inteira, porque ela junta duas coisas diferentes:

"É importante adicionar uma forma de pagamento para poder enviar mensagens de template. E a partir de outubro todas as mensagens enviadas pela API serão cobradas."

Ou seja: sem forma de pagamento cadastrada, o envio de template não acontece. E a gratuidade que ainda existe para responder o cliente tem prazo.

Como cadastrar a forma de pagamento, passo a passo

O cartão não é cadastrado na Datafy: ele é cadastrado na sua BM, dentro do Facebook.

1. Acesse a sua BM no Facebook. A Meta pode pedir confirmação de identidade: "a todo instante ele exige confirmação de identidade."
2. Na BM, abra contas do WhatsApp. Ali aparecem "todos os números que você conecta nessa BM".
3. Clique no número que você acabou de conectar.
4. Abra o resumo (a aba aparece como summary).
5. Desça até configurações do pagamento.
6. Adicione o seu cartão de crédito.

Feito isso, "quando você for enviar mensagens, a meta vai descontar diretamente daqui".

Quem cobra o quê

A frase do vídeo não deixa dúvida: "você não paga mensagens para a Datafy. Não existe nenhuma cobrança por parte da Datafy em relação às mensagens, é tudo diretamente com a meta. Para a Datafy API, você vai pagar somente a conexão com o WhatsApp, ou seja, toda a infraestrutura que foi resolvida aqui."

E, sobre o preço da conexão, ele diz que é por número conectado, e que "você vai tendo descontos ali com o volume". A tabela vigente:

Confira sempre a tabela publicada no site, porque valor de tabela muda.

O primeiro teste depois de conectar

Com o número conectado, o próximo passo é a API. Como ele diz no fim: "existe a documentação onde tem tudo explicadinho."

O primeiro comando útil é o que devolve os seus identificadores, porque quem tem só o token ainda não sabe o phone_number_id:

GET https://cloud.datafyapi.com.br/me
Authorization: Bearer sk_live_xxx

{
  "cliente_id": "uuid-do-cliente",
  "phone_number_id": "106540352242922",
  "waba_id": "366634483210360",
  "business_id": "123456789"
}

Com o phone_number_id em mãos, a primeira mensagem sai assim, para alguém que falou com você nas últimas 24 horas:

POST https://cloud.datafyapi.com.br/v1/{phone_number_id}/messages
Authorization: Bearer sk_live_xxx
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "text",
  "text": { "body": "Olá! Já estamos conectados na API oficial." }
}

O token vai sempre no cabeçalho. A URL é a da Datafy, e o resto do corpo é igual ao da documentação da Meta.

Para falar com quem não mandou mensagem nas últimas 24 horas, o caminho é outro: template aprovado, e é por isso que a forma de pagamento importa desde o primeiro dia.

Perguntas frequentes

Preciso ter uma BM verificada para conectar?

Não para começar. Você precisa ter um portfólio empresarial, e dá para criar um durante a própria conexão.

Meu número continua funcionando no celular?

Continua, se você escolher a opção de conectar o app do WhatsApp Business que já existe. É o modo de coexistência: o aplicativo segue em uso e a API passa a trabalhar no mesmo número.

Sou obrigado a compartilhar o histórico de conversas?

Não. O celular pergunta se você deseja compartilhar o histórico de conversas e mensagens, e a escolha é sua.

Quanto tempo leva a conexão?

A parte do QR code leva até 45 segundos. Somando o cadastro, a escolha do portfólio, o código do e-mail e a conclusão, o processo inteiro fica na casa dos cinco minutos.

Preciso cadastrar cartão para conectar o número?

Não para conectar. O cartão é necessário para enviar mensagens de template, e ele é cadastrado na sua BM, não na Datafy.

Por que aparece o nome Datafy Chats na tela do celular?

Porque é o nome da entidade verificada da Datafy junto à Meta. É ele que aparece no fluxo de conexão.

Para que serve o nome que eu dou na criação do número?

É o apelido da conexão dentro do painel, como o "suporte" usado no vídeo. Serve para você identificar cada número quando tiver vários.

Como decidir

Se o número que você quer usar já está no seu celular e o atendimento não pode parar, escolha a opção de conectar o aplicativo existente. Se é um chip novo, escolha criar a conta do WhatsApp Business. Em qualquer um dos dois casos, deixe o celular ao lado: ele recebe a mensagem do Facebook, confirma a plataforma e escaneia o QR code.

A forma mais fácil e simples de usar a API oficial do WhatsAppCanal DATA7 · 9 min · assistir no YouTube

Leia também

• Enviar e receber a primeira mensagem, e cadastrar o webhook
• A Datafy API é um espelho da Cloud API: o que muda no seu código
• Como sincronizar os contatos e o histórico na coexistência
• Quanto custa a API oficial do WhatsApp no Brasil