Ir para o conteúdo
Gestor › Canais de atendimento › WhatsApp API Oficial

Contratar e configurar

Os dois caminhos para ligar um número da API Oficial à SM Click — e como escolher entre eles.

Existem dois caminhos para ligar um número da API Oficial. A tela da instância mostra os dois, separados por um OU — e vale escolher antes de começar, porque o trabalho é bem diferente.

O mesmo processo em vídeo, se preferir acompanhar assim.

Antes de escolher

Nos dois caminhos, o número precisa estar configurado e verificado na Meta. Isso é feito do lado de lá, e não depende da SM Click.

Se você ainda não chegou nesse ponto, comece pela outra ponta:

→ Preparar a conta na Meta, do zero até o número conectado

Isso não é feito em minutos

A verificação do número e a aprovação da conta dependem da Meta. Pode levar dias, e nenhum dos dois caminhos abaixo encurta essa espera — eles mudam só o trabalho de ligar o número já aprovado à SM Click.

Se o seu atendimento não pode parar nesse meio-tempo, mantenha o canal atual funcionando e só migre quando a API Oficial estiver pronta.

Os dois caminhos

Login IncorporadoAplicativo próprio
Como éVocê entra com o Facebook e autoriza numa janela da MetaVocê cria um aplicativo na Meta e copia credenciais para a SM Click
O que você copiaNadaURL, token de verificação, dois identificadores e um token permanente
Precisa de aplicativo criado?NãoSim
Quem fazQuem administra a conta comercialAlguém que saiba mexer no Facebook Developers
Quando usarNa maioria dos casosQuando você já tem um aplicativo próprio, ou precisa dele por outro motivo
Comece pelo Login Incorporado

É o caminho recomendado, e o único que não envolve copiar token nenhum. A janela da Meta devolve as credenciais para a SM Click sozinha — some de uma vez a origem mais comum de erro nesta configuração, que é colar um identificador no campo errado.

O caminho do aplicativo próprio continua existindo e não vai sair. Ele faz sentido quando a sua empresa já mantém um aplicativo na Meta para outra finalidade e quer usar o mesmo.

Caminho 1 — Login Incorporado

Na tela da instância, no bloco Opção Rápida — Login pelo Facebook:

  1. Acesse a instância na SM Click e selecione o tipo API Oficial Meta.
  2. Clique em Conectar com Login Incorporado.
  3. Uma janela da Meta abre. Entre com a conta do Facebook que administra o WhatsApp Business da empresa.
  4. Autorize o acesso e escolha o número que será conectado.
  5. A janela fecha sozinha. O botão passa a mostrar Conectado com sucesso!

Pronto. Os identificadores e o token ficam guardados pela SM Click — você não vê nem copia nenhum deles.

Entre com a conta certa

A janela usa a conta do Facebook que já estiver conectada no seu navegador. Se a empresa tem uma conta administrativa separada da sua pessoal, é fácil autorizar com a errada.

Confirme qual conta aparece na janela antes de autorizar. Se for a errada, saia do Facebook naquele navegador — ou use uma janela anônima — e comece de novo.

Se o botão não aparecer ou a janela não abrir

O bloqueador de janelas do navegador é a causa mais comum: o fluxo abre uma janela nova, e alguns navegadores barram sem avisar direito. Libere para o endereço da plataforma e tente de novo.

Persistindo, use o caminho do aplicativo próprio abaixo, ou fale com o suporte.

Caminho 2 — Aplicativo próprio

É o caminho abaixo do OU na mesma tela, em quatro passos numerados. Ele exige que você já tenha um aplicativo criado no Facebook Developers e saiba onde ficam os identificadores.

Esta é a parte mais trabalhosa do processo, porque metade dela acontece nas ferramentas da Meta, não na SM Click. Reserve um tempo tranquilo e siga na ordem.

O que você precisa ter antes

Além do número verificado, este caminho exige:

  • Um aplicativo criado no Facebook Developers
  • A identificação do número de telefone
  • A identificação da conta do WhatsApp Business
  • Um token de acesso permanente

Os passos 5 e 6 abaixo mostram como obter os identificadores e o token, caso já tenha o aplicativo.

Passo 1 — Mudar a conexão para API Oficial

  1. Acesse a instância na plataforma SM Click.
  2. Clique no ícone de lápis para editar a instância.
  3. Selecione a opção API Oficial Meta e clique em Salvar.
  4. Confirme que o ícone mudou, indicando a conexão via API Oficial.

Passo 2 — Configurar a URL de retorno e o token de verificação

  1. Copie a URL e o token fornecidos pela SM Click.
  2. Acesse a plataforma de desenvolvedores do Facebook e selecione o seu aplicativo.
  3. Vá até a guia WhatsApp e clique em Configuração.
  4. Cole a URL do webhook e o token copiados da SM Click.
  5. Clique em Verificar e Salvar.

Tela de configuração do webhook no Facebook Developers, com os campos de URL e token preenchidos

Passo 3 — Assinar os componentes

Na plataforma do Facebook, assine todos os componentes permitidos. Os que não puderem ser assinados podem ser ignorados.

Lista de componentes do webhook, com as assinaturas ativadas

É aqui que a maioria dos problemas começa

Se algum componente ficar sem assinar, o sintoma aparece depois: mensagens que não chegam, ou status de entrega que nunca atualiza. Confira essa tela antes de seguir.

Passo 4 — Testar a conexão

Volte à SM Click e clique em Testar. Se a conexão for bem-sucedida, siga adiante.

Passo 5 — Informar os dois identificadores

  1. Nas configurações do WhatsApp no Developer, copie a Identificação do número de telefone.
  2. Cole na SM Click.
  3. No mesmo lugar, copie a Identificação da conta do WhatsApp Business.
  4. Cole na SM Click.

Passo 6 — Gerar o token permanente

Este token é o que mantém a conexão viva. Se ele expirar, o canal para.

  1. Acesse a Configuração do Negócio.
  2. No menu lateral, escolha Usuário do Sistema.
  3. Clique em Adicionar e escolha a função Administrador.

Criação de um usuário do sistema com função de administrador

  1. Escolha Atribuir Ativos.
  2. Adicione o aplicativo que você criou.

Tela de atribuição de ativos ao usuário do sistema

  1. Na duração do token, escolha Nunca.
  2. Marque estas três permissões:
    • business_management
    • whatsapp_business_management
    • whatsapp_business_messaging

Seleção da duração do token e das três permissões necessárias

  1. Clique em Gerar Token e copie o resultado.
  2. Cole o token permanente na SM Click.
Guarde o token com cuidado

Esse token dá acesso ao envio de mensagens em nome da sua empresa. Trate como senha: não mande por conversa, não cole em planilha compartilhada. A Meta mostra o token uma única vez — se você perder, terá de gerar outro.

Depois de conectar — vale para os dois caminhos

Daqui em diante o processo é o mesmo, tenha você usado o Login Incorporado ou o aplicativo próprio.

Configurar os modelos de mensagem

Na API Oficial, você não pode simplesmente escrever para alguém que não falou com você. Precisa usar um modelo aprovado pela Meta — o template.

  1. Na SM Click, clique no ícone de megafone para configurar os modelos.

  2. Crie um modelo novo, escolhendo entre as categorias Marketing ou Utilidade.

  3. Envie o modelo para a Meta e aguarde a aprovação.

  4. Aprovado, ele fica disponível para uso.

Formulário de criação de um modelo de mensagem

→ Detalhes em modelos de mensagem.

Usar

  1. Acesse a tela do atendente.
  2. Inicie a conversa enviando um modelo aprovado ao cliente.
  3. Quando o cliente responder, a conversa segue normalmente pelas 24 horas seguintes.

Envio de um modelo de mensagem pela tela do atendente

Para falar com a pessoa depois dessa janela de 24 horas, é preciso enviar um novo modelo. Isso está explicado em o que é a API Oficial.

Estas páginas são da própria Meta e mudam sem aviso, mas são a fonte oficial:

Se algo não funcionar

A página de erros mais comuns lista o que a API Oficial costuma retornar e o que fazer em cada caso.

Atualizado em