Pular para o conteúdo
OrulTutoriais

Conectar o WhatsApp via Integração Alternativa (QR Code)

Vincule um número de WhatsApp escaneando um QR Code e escolha quais mensagens o Toty envia automaticamente. Inclui também a opção de webhooks da API oficial.

Como chegar

No menu lateral, vá em Configurações → WhatsApp. O hub tem duas abas: Integração API Oficial Meta (webhooks) e Integração Alternativa (conecta um número existente por QR Code, via Userhat). Para o caminho mais rápido, use a Integração Alternativa.

O fluxo completo de vínculo do dispositivo.

Conectar por QR Code (Integração Alternativa)

  1. Abra a aba Integração Alternativa

    Em Configurações → WhatsApp, clique na aba Integração Alternativa e depois em + Novo dispositivo.

  2. Preencha os dados do dispositivo

    No formulário do novo dispositivo, informe:

    • Apelido — visível só para o admin (máx. 32 caracteres).
    • Empresas — as lojas que usam esse número.
    • Telefone — o número do WhatsApp.
    • Status — Ativo ou Pausado.
    • Módulos de envio (chips) — Pontuação, Resgate de Recompensa, Pontos expirando, Avaliação NPS, Campanhas, Sorteios, Código de verificação (há Marcar/Desmarcar todos).
  3. Vincule e escaneie o QR Code

    Clique em Vincular Dispositivo. Abre um popup do Userhat com um QR Code. No celular, abra o WhatsApp → Aparelhos conectados → Conectar um aparelho e escaneie o código.

    Popup com QR Code para vincular o número de WhatsApp pelo celular
    Leitura do QR Code para vincular o dispositivo.
  4. Confirme e salve

    Ao provisionar, o dispositivo fica vinculado e o status de conexão aparece como badge colorido na lista (Conectado / Conectando / Desconectado). Clique em Salvar para persistir.

Atenção

Se outro dispositivo já cobre os mesmos módulos para as mesmas empresas, o Toty detecta o conflito, pede confirmação e o resolve removendo os módulos duplicados do outro dispositivo. Confira na lista qual aparelho ficou responsável por cada módulo.

Alternativa: webhooks da API Oficial Meta

Se preferir a API Oficial Meta, use a aba Integração API Oficial e clique em + Novo Webhook. Informe:

  • Descrição e URL do webhook.
  • Empresas e Tech Provider.
  • Tipo do evento — Pontuação, Resgate, Pontos próximos à expiração, NPS, Campanhas, Código de verificação.
  • Ativo — liga o webhook.

O Toty detecta conflitos de empresa + tipo entre webhooks. O payload entregue ao seu endpoint se parece com:

exemplo-webhook.jsonjson
{
  "event": "score.created",
  "company": "loja-centro",
  "customer": { "phone": "5591999990000" },
  "points": 12
}