Como integrar o Whaticket com o Zapier e o Typeform

Com o Typeform, o Zapier e a API do Whaticket, cada pessoa que responde um formulário recebe na hora uma mensagem de WhatsApp e já aparece como chat na sua conta. O Zapier recebe a resposta do Typeform e chama a API da Whaticket, que envia a mensagem pela conexão que você escolher.

O que muda para sua operação

O primeiro contato com cada lead sai automaticamente, sem ninguém copiar dados do formulário.
O chat pode nascer atribuído a um atendente ou a um departamento.
Os dados do formulário viram contato na Whaticket.

Antes de começar

Uma conta no Typeform com pelo menos um formulário publicado e uma resposta de teste.
Uma conta no Zapier.
Seu perfil na Whaticket precisa da permissão Criar do grupo Tokens de API para gerar o token.
O perfil escolhido para o token precisa das permissões Criar e Iniciar do grupo Campanhas. É com elas que a API envia mensagens.
Se a conexão for WhatsApp QR Code, cada mensagem enviada pela API consome créditos de campanha. Confira seu saldo antes de ativar a automação.

Passo a passo:

Crie o token de API na Whaticket

No menu à esquerda, clique em Integrações.
Na aba Tokens, clique em Novo token.
Dê um Nome ao token, como “Zapier Typeform”, e escolha o Perfil. O token herda as permissões desse perfil.
Salve e copie a chave na janela Copie a chave do token. Ela só aparece uma vez. Se perder, use Regenerar para criar uma nova.

Copie os IDs que a requisição usa

Em Conexões, clique em Editar na conexão que vai enviar as mensagens e clique no ícone de copiar ao lado do título Editar Conexão. Esse é o ID da conexão.
Se quiser atribuir o chat a um atendente, abra Equipe, edite o usuário e copie o ID pelo ícone ao lado do título.
Se quiser direcionar o chat a um departamento, abra Departamentos & Chatbots, edite o departamento e copie o ID pelo ícone Copiar ID.

Prepare o formulário no Typeform

Entre no Typeform e crie um formulário ou use um modelo.
Inclua pelo menos os campos de nome e número de WhatsApp.
Publique o formulário e envie uma resposta de teste. O Zapier usa essa resposta para reconhecer os campos.

Crie o Zap e configure o gatilho

No Zapier, abra Zaps e clique em Create.
Escolha o app Typeform e o evento New Entry.
Conecte sua conta do Typeform, selecione o formulário e clique em Continue.
Teste o gatilho e confira se o nome e o telefone aparecem nos dados capturados.

Formate o número de telefone

Adicione uma etapa com o app Formatter by Zapier e o evento Text.
Em Transform, escolha Replace.
Em Value, selecione o telefone do formulário. Em Find, escreva + e deixe Replace vazio.
Teste a etapa e confira em Data Out se o número saiu sem o +.

A API da Whaticket só aceita números com dígitos, no formato internacional com código do país e DDD, por exemplo 5511999998888. O número não pode começar com 0.

Configure a chamada à API da Whaticket

Adicione uma etapa com o app Webhooks by Zapier e o evento Custom Request.
Em Method, escolha POST.
Em URL, informe https://api.whaticket.com/api/v1/messages.
Em Data Pass-Through, escolha false e, em Unflatten, escolha Yes.
Em Headers, adicione Content-Type com o valor application/json e Authorization com o valor Bearer seguido de um espaço e da chave do token.

No campo Body, cole o JSON abaixo e troque os valores pelos dados do formulário usando o botão + do Zapier:

{
  "connectionId": "ID_DA_SUA_CONEXAO",
  "messages": [
    {
      "number": "telefone_sem_mais",
      "name": "Nome do contato",
      "body": "Mensagem que será enviada ao contato",
      "ticketData": {
        "userId": "ID_DO_USUARIO",
        "queueId": "ID_DO_DEPARTAMENTO",
        "status": "open",
        "keepAssigned": true,
        "keepAssignedUntil": "2026-12-31",
        "force": true
      }
    }
  ]
}

connectionId: ID da conexão que envia a mensagem. O campo antigo whatsappId ainda é aceito.
number: telefone do formulário, já sem o +.
name: nome do contato, com pelo menos 3 caracteres. É usado para criar o contato se ele ainda não existir.
body: texto da mensagem.
ticketData: opcional. Define o atendente (userId), o departamento (queueId) e o status do chat (open, pending ou closed).
keepAssigned e keepAssignedUntil: opcionais. Mantêm o chat com o mesmo atendente quando o contato responder. Exigem userId, e a data precisa ser futura, no formato AAAA-MM-DD.

Teste e ative o Zap

Clique em Test.
Se tudo estiver certo, a resposta traz messages scheduled.
Se aparecer um erro, o Zapier mostra o motivo. Corrija e teste de novo.
Clique em Turn on para ativar o Zap.

Perguntas frequentes

Onde o contato aparece na Whaticket?
Como chat da conexão escolhida. Com ticketData, ele vai para o atendente ou departamento informado, no status que você definiu. Sem ticketData, o chat é criado como resolvido.

A API recusa o envio se eu não tiver créditos?
Não. A resposta troca messages scheduled por um aviso com o seu saldo, e as mensagens que consomem crédito ficam aguardando até você adicionar créditos.

Quais conexões consomem créditos?
Apenas WhatsApp QR Code. Conexões WhatsApp API Cloud e Coexistência não consomem créditos, mas exigem um modelo aprovado no campo templateId.

Onde vejo todos os campos da API?
Em Integrações, aba Documentação. Lá também dá para testar as chamadas.

Os créditos vencem?
Não. Os créditos não têm data de vencimento.

Quem responde por erros na integração?
A Whaticket não se responsabiliza por erros de configuração, falta de créditos ou custos das plataformas externas usadas na integração. Se possível, conte com um desenvolvedor para validar o mapeamento dos campos e o JSON.