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

Contratar e configurar

O passo a passo completo para ligar um número da API Oficial à SM Click.

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

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

Antes de começar

Você precisa ter, já prontos, do lado da Meta:

  • O número configurado e verificado na plataforma da Meta
  • 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 de longa duração

Os passos 6 e 7 abaixo mostram como obter os dois últimos, caso ainda não tenha.

Isso não é feito em minutos

A verificação do número e a aprovação da conta dependem da Meta, não da SM Click. Pode levar dias. 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.

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.

Tela de edição da instância na SM Click, com a opção API Oficial Meta selecionada

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.

Botão de teste de conexão na SM Click, com resultado positivo

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.

Campos de identificação do número e da conta preenchidos 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.

Token gerado, pronto para ser copiado

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.

Passo 7 — 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.

Ícone de megafone que abre a área de modelos de mensagem

  1. Crie um modelo novo, escolhendo entre as categorias Marketing ou Utilidade.
  2. Envie o modelo para a Meta e aguarde a aprovação.
  3. Aprovado, ele fica disponível para uso.

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

→ Detalhes em modelos de mensagem.

Passo 8 — 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.