SAK Suporte SAK Suporte Entre em contato

Como configurar a API Oficial- Meta/WhatsApp e Cloud API?

Atualizado em 21/05/2026

Link copiado!

Configurando API Oficial

Configure a API Oficial do WhatsApp e a integre ao Sak seguindo o passo a passo abaixo:

1. Acessar o Meta Business Suite

  1. Clique aqui e acesse o Meta Bussiness Suite;
  2. Faça login na sua conta do Facebook que será responsável pela API;

2. Selecionar ou criar o Portfólio Empresarial

  1. No canto superior esquerdo, clique no seletor de empresas e escolha o Portfólio Empresarial correto;
  2. Caso ainda não exista um: clique em "Criar portfólio empresarial"; Preencha as informações: Nome da empresa, Seu nome, Email corporativo; Finalize a criação.

⚠️ Se este for o primeiro Portfólio Empresarial criado, será necessário submeter os dados da empresa para verificação junto à Meta. Após a aprovação, o número oficial e a API ficarão vinculados ao portfólio.)

⚠️ Importante: O aplicativo da API do WhatsApp ficará vinculado a esse portfólio empresarial. Depois, a verificação da empresa e o número oficial também ficarão associados a ele.

3. Acessar a área de desenvolvedores da Meta

  1. Entre em: Meus Apps — Meta Developers;
  2. Clique em “Criar aplicativo”.

4. Preencher os dados iniciais do app

  1. Preencha: Nome do aplicativo e Email de contato;
  2. Clique em "Avançar".



5. Selecionar o caso de uso

  1. Na etapa “Casos de uso”, role até o final da página e escolha: “Outro” 
  2. Clique em “Avançar”.


⚠️ Importante: Mesmo aparecendo “going away soon”, essa ainda é a opção utilizada para configurar corretamente a API do WhatsApp Cloud nesse fluxo.

6. Escolher o tipo do aplicativo

  1. Selecione: Business (Negócios / Empresas);
  2. Clique em "Avançar".




7. Vincular o Portfólio Empresarial

Nessa tela, os dados do aplicativo normalmente já virão preenchidos automaticamente.

Você só precisa:

  1. Clicar em “Nenhum portfólio empresarial selecionado”;
  2. Selecionar o portfólio empresarial correto da empresa;
  3. Clicar em “Criar aplicativo”.

⚠️ Importante: O portfólio empresarial será responsável pelo gerenciamento da API oficial do WhatsApp, número oficial e verificação da empresa.




8. Adicionar o produto WhatsApp

  1. Na tela de produtos, selecione: WhatsApp e clique na opção de configurar.



9. Ativar ambiente de testes da API

  1. Clique em "WhatsApp";
  2. Aperte em "Configuração da API".

  4. Na seção “Etapa 5: Adicione um número de telefone”, clique no botão:
  5. “Adicionar telefone”
  6. Nessa etapa você irá: Vincular o número oficial do WhatsApp
  7. Vincular o número oficial do WhatsApp;
  8. Configurar o nome da empresa;
  9. Escolher a categoria do negócio;
  10. Receber o código de verificação da Meta;

⚠️ Importante: O número não pode estar conectado atualmente ao WhatsApp comum ou WhatsApp Business App.

Ele precisa estar livre para uso na API oficial da Meta.



11. Após adicionar e verificar o número, selecione o número de telefone que acabou de ser configurado.

10. Integrar o número no SAK

  1. Depois de configurar o número na Meta, volte para o painel do SAK.
  2. Vá em "Configurações"
  3.  Em "WhatsApp", clique em "Adicionar novo número";
  4. Depois selecione a opção: "WhatsApp Cloud API".








Em seguida, será necessário conectar as informações da Meta para finalizar a integração do número oficial ao sistema. Primeiro, você vai precisar pegar a identificação da Conta do WhatsApp Business, pois ela já será utilizada no processo.

  1. No Meta Business Suite, acesse: "Contas"
  2. Clique em "Contas do WhatsApp";
  3. Copie o ID da Conta do WhatsApp Business e coloque no Sak, no campo “ID da conta”. 




Depois disso, siga para criação do usuário do sistema:

Se não existir nenhum usuário do sistema:

  1. Clique em “Adicionar” no canto superior direito;
  2. Crie um novo usuário do sistema;
  3. Marque a opção "Administrador";
  4. Clique em "Criar usuário do sistema".

Em seguida, adicione os ativos:

  1. Clique em “Adicionar ativos”;
  2. Selecione o Aplicativo criado anteriormente;
  3. Selecione também a Conta do WhatsApp Business;
  4. Dê acesso total / controle total para ambos;
  5. Clique em "Atribuir ativos".




Agora sim, gerar o token:

  1. Clique em "Gerar token"
  2. Selecione o app "SAK"
  3. Clique em "Avançar".



Definir expiração do token:

  1. Na opção “Quando o token deve expirar?”, 
  2. Selecione: "Nunca e avançar".



Em "Permissões obrigatórias", Marque: whatsapp_business_management e whatsapp_business_messaging



  1. Clique em "Generate token";
  2. Copie o token gerado;
  3. Cole no SAK no campo “Token de usuário de sistema”.

⚠️ Importante: Sem adicionar o aplicativo e liberar acesso total ao usuário do sistema, o token não funcionará corretamente na integração.

Agora vamos preencher os links obrigatórios da Meta:

Antes de qualquer outra configuração, você precisa adicionar 3 links obrigatórios no app da Meta:

Por que isso é necessário?
 A Meta exige esses links para garantir transparência sobre o uso de dados do usuário.

1. Política de Privacidade: Adicione um link válido (site da empresa ou página simples).

Exemplo:
 https://seudominio.com/politica

2. Termos de Serviço: Pode ser o mesmo site ou uma página separada:

Exemplo:
 https://seudominio.com/termos

3. URL de exclusão de dados: Página explicando como o usuário pode solicitar remoção de dados:

Exemplo:
 https://seudominio.com/excluir-dados

Depois disso, desça a tela e clique em "Salvar alterações".



Em seguida: configurar Webhooks

  1. Vá em: WhatsApp;
  2. Clique em "Configuração";
  3. Aperte em "Webhooks";
  4. Em “Selecionar produto”, escolha: WhatsApp Business Account;


Agora volte no SAK e copie:

  • Callback URL (do SAK);
  • Verify Token (do SAK);






Cole na Meta:

  • Cole a Callback URL
  • Cole o Verify Token

Clique em “Verificar e salvar”.




Ativar eventos do Webhook

Ainda na tela de Webhooks, marque os eventos como “Assinado”:

  •  messages
  •  message_template_status_update




Isso permite que a Meta envie eventos automaticamente para o SAK.

O que cada evento faz:

Messages: Recebe mensagens do cliente (texto, áudio, imagem, etc.)

message_template_status_update: Atualiza status de templates (aprovado, rejeitado, em análise)

Por fim: ativar o modo Ao Vivo

Depois de configurar tudo acima:

  1. Vá em "Modo de desenvolvimento";
  2. Marque “Ao vivo”.


Isso só deve ser feito depois dos links obrigatórios estarem preenchidos.

O que muda no modo Ao Vivo:

  • O app sai do teste
  • Passa a funcionar com clientes reais
  • A API da Meta fica oficialmente ativa

Teste final

Envie uma mensagem para o número conectado à API e verifique se chega no SAK.

 Se não funcionar, verifique:

  • Webhook salvo corretamente
  • Token válido (não expirado)
  • Número selecionado no produto WhatsApp
  • App realmente em modo Ao vivo

 E sim, quem está criando o app do zero também precisa lembrar de submeter os dados da empresa antes de liberar o modo ao vivo.

É importante lembrar de configurar forma de pagamento na Meta

Você acessa em "Meta Business Suite";

Clique em "Contas do WhatsApp"; 

Aperte em "Configuração de pagamento".







 Depois disso você vai:

  1. Entrar no Meta Pay / Billing
  2. Clicar em "Adicionar forma de pagamento"
  3. Escolher "Cartão de crédito"
  4. Inserir os dados do cartão;
  5. Clique em "Salvar".

 Importante

Se depois de adicionar continuar aparecendo “nenhuma forma de pagamento”, normalmente é por:

  • Cartão recusado ou sem liberação internacional
  • Conta ainda sem permissões de billing
  • Empresa ainda em processo de verificação

Finalização da Configuração

Se você seguiu todos os passos acima, sua API Oficial do WhatsApp (Meta Cloud API) já está completamente configurada e pronta para uso.

Agora seu ambiente conta com:

  •  App criado corretamente na Meta Developers
  • Portfólio empresarial vinculado
  • Número do WhatsApp conectado à API
  • Webhooks ativos e recebendo eventos
  • Usuário do sistema e token configurados
  • Links obrigatórios (privacidade, termos e exclusão de dados) adicionados
  •  Pagamento configurado no Meta Billing
  • App pronto 

O que achou da resposta?

Ótima Neutra Péssima

Não encontrou o que precisava? Entre em contato

Artigos visitados

Artigos relacionados