Pular para o conteúdo principal

Como conectar a API oficial

Tutorial em vídeo com o passo a passo completo: da instância vazia até a API oficial conectada, incluindo Meta Business, QR Code, forma de pagamento, fusão com a instância não oficial e uso no GoHighLevel.

Link direto: Assistir no YouTube

O que você vai precisar​

  • Uma instância vazia no Stevo (sem número conectado).
  • Acesso à Meta Business (BM) com permissão para conectar o WhatsApp Business.
  • Número de telefone válido (com DDI; exemplo: Brasil +55).
  • Cartão de crédito cadastrado na BM (obrigatório para a API oficial funcionar corretamente).
  • Se for integrar ao GHL, o fluxo de conexão do número conforme seu plano Stevo.

1. Criar e nomear a instância​

  1. Escolha qualquer instância vazia na lista.
  2. Clique para criar / definir o nome da instância (ex.: “Cai oficial”).
  3. Selecione a instância recém-nomeada para abrir o painel.

2. Conectar o WhatsApp Business (fluxo Meta)​

  1. Na tela da instância, clique em Conectar WhatsApp Business.
  2. Será exibido o fluxo oficial da Meta para vincular o número ao provedor (BSP).
    • Não é possível pular essa etapa: conexão Business com o provedor exige esse fluxo, assim como em outras plataformas que oferecem API oficial (GHL, etc.).
  3. Clique em Continuar e siga as telas da sua BM (cada BM pode ter botões em posições diferentes, mas o fluxo é o mesmo).
  4. Quando aparecer “Conectar um app” / app do WhatsApp Business, selecione e avance.
  5. Informe o DDI correto (ex.: Brasil) e o número de telefone que será conectado.
  6. Será gerado um QR Code. No celular, no app WhatsApp Business (Meta), confirme a mensagem e toque em Connect / conectar à plataforma, compartilhando as conversas conforme solicitado.
  7. Após a leitura do QR, aguarde cerca de 45 segundos (ou um pouco mais) até a Meta finalizar.
Tela “primeiro cliente” / marca

Pode aparecer identificação do primeiro cliente / BSP no fluxo. Isso é normal na API oficial; a conexão Business com a Meta exige esse caminho.

3. Finalizar no computador (fuso e conta)​

  1. Na etapa pós-QR, escolha o fuso horário (ex.: São Paulo / Brasília, UTC−3).
  2. Confirme os dados; a conta será vinculada.
  3. A Meta pode pedir forma de pagamento — antes de preencher cartão, você pode clicar em Concluir para processar e montar a API oficial na Stevo.
  4. Aguarde alguns segundos até cerca de 1 minuto para a Meta processar por dentro.

4. Verificar conexão na Stevo (token, WABA, número)​

Na instância, após processar:

  • Devem aparecer WABA ID, NUMBER e o token quando aplicável.
  • A aba Saúde pode mostrar qualidade / verificação ainda em atualização; dê refresh na página até aparecer foto e número ligados à conta.
  • Quando a Meta finalizar, o painel reflete número e foto corretamente.

5. Forma de pagamento na Meta Business (obrigatório)​

  1. Em Saúde, acesse o atalho para a Meta Business da BM.
  2. Vá em Configurações → Contas do WhatsApp → Configurações de pagamento (caminho pode variar levemente na interface da Meta).
  3. Adicione forma de pagamento (cartão de crédito). Sem cartão, a operação pode falhar em momentos críticos.
  4. Escolha a moeda (ex.: USD) e complete os dados.
  5. Garanta que o cartão fique como padrão (menu “⋯” → definir como padrão, se necessário).

6. Fusão: API oficial + não oficial (mesmo número)​

Desconecta tudo no número

Ao preparar a fusão, o processo desconecta o que estiver ligado à API não oficial e à API oficial naquele fluxo — WhatsApp, GHL, etc., conforme o tutorial. Planeje a janela de manutenção.

  1. Conecte primeiro o número no GHL (ou fluxo desejado), ex.: como “número 2”, conforme seu painel.
  2. Na API oficial, mantenha o mesmo número alinhado ao fluxo (ex.: instância “22” / oficial da mesma linha — siga os nomes do seu painel).
  3. Com os dois lados no mesmo número, use o ícone de raios / fusão na Stevo.
  4. A fusão só aparece entre instâncias com o mesmo número; selecione o par e ative a fusão.
  5. Após ativar, o indicador de fusão ativa aparece na interface.

7. Switch automático (opcional)​

Para alternar envio/recebimento para a API oficial automaticamente em alguns cenários:

  1. Configurações → Gerenciar números.
  2. Configure o switch automático para o número desejado.
  3. Ao enviar mensagem pela rota correta, o sistema pode mudar para a instância oficial (“Cai oficial”, etc.) conforme a regra configurada.

8. Saúde e limites de mensagens (Meta)​

Em Saúde, com o tempo você verá mensagens entregues/enviadas nos últimos 7 dias. A Meta evolui os níveis de limite (ex.: começo em torno de 250, depois 1.000, 2.000, etc.) conforme o uso e a reputação — isso é regra da Meta, não da Stevo.

9. Templates (criar e aprovar)​

  1. Em Gerenciar modelos / Templates, crie o modelo (nome, categoria Marketing ou outra, cabeçalho, corpo com ou sem variáveis (ex.: variável 1 no formato da Meta), rodapé opcional, botões de resposta rápida / URL / telefone — até 10 botões; acima disso o WhatsApp pode exibir como lista).
  2. Ao criar, o modelo é enviado à Meta para aprovação. Até aprovar, aguarde.
  3. Variáveis: se o template tiver variável, na hora de enviar você escolhe primeiro nome, telefone, campo customizado do GHL, etc.
Script de templates no GHL

O vídeo menciona um script para listar templates aprovados no GHL. Esse script costuma estar na descrição do vídeo, nos tutoriais da Stevo e no grupo de beta da API oficial, quando disponível.

10. Enviar template pelo sistema​

  1. Use o fluxo do script (copiar/colar no GHL) para listar templates aprovados da conta oficial.
  2. Selecione o número e o template; é possível enviar direto, pré-visualizar ou copiar código gerado para usar em automações ou mensagens.
  3. Se houver variáveis, preencha antes de enviar (ex.: nome).

11. Disparo em massa (API oficial)​

  1. Escolha o template e as variáveis.
  2. Em disparo em massa, selecione por exemplo uma tag do GHL para buscar contatos.
  3. O disparo segue o protocolo da Meta: lotes de 80 contatos a cada ~60 segundos (limite imposto pela Meta, não configurável pela Stevo).

Resumo​

EtapaO que fazer
InstânciaCriar nome em instância vazia
MetaConectar WhatsApp Business, QR, fuso
StevoConferir token, WABA, número; atualizar página
PagamentoCartão na BM, moeda, cartão padrão
FusãoMesmo número nas duas pontas → ativar raio
GHLConectar número; switch automático se quiser
TemplatesCriar, aprovar Meta, usar script / disparos

Dúvidas: canal de suporte da Stevo. Se o vídeo ajudou, compartilhe com quem usa GoHighLevel e Stevo.

Conteúdo baseado no tutorial em vídeo da Stevo. Interface pode mudar entre versões do produto.