Wevi | Central de Ajuda
Central de Ajuda › Conectar a Wevichat a outros sistemas

Conectar a Wevichat a outros sistemas

Nível: Intermediário Tempo de leitura: 6 min Plano necessário: Todos os planos (campanhas exigem Pro ou Ultra)

Para quem é

Para quem quer ligar a Wevichat ao resto da operação: o CRM, o sistema de pedidos, a planilha, uma ferramenta de automação como n8n, Make ou Zapier, ou um sistema feito na casa.

Se você só usa o painel, não precisa deste artigo. Ele é o mapa para quem vai colocar a Wevichat para conversar com outro sistema.

Você não precisa saber programar para ler até o fim. A parte técnica de verdade fica em wevi.chat/docs/api, e este artigo serve para você entender o que é possível e decidir se vale a pena antes de chamar alguém.

O que dá para fazer

Quase tudo que o painel faz, outro sistema também pode fazer. É a mesma API que o nosso painel usa por dentro, então não existe recurso guardado para uso interno.

Área Exemplos do que dá para fazer
Contatos Criar e atualizar, aplicar etiquetas, preencher campos próprios, mover de etapa no funil, definir o dono da carteira
Conversas Ler o histórico, assumir o atendimento no lugar da IA, devolver para a IA, encerrar
Mensagens Enviar template aprovado, texto livre dentro da janela de 24 horas, botões, listas e cards de produto
Agentes Conversar com um agente de IA direto pela API, sem passar pelo WhatsApp
Campanhas Disparar para uma lista e acompanhar o resultado
Automações Começar um fluxo quando algo acontece no seu sistema
Webhooks Receber um aviso no seu servidor quando algo acontece na Wevichat

Os três caminhos

Existem três jeitos de fazer essa ligação, do mais fácil para o mais trabalhoso. Escolha pelo que você já tem em casa.

1. Nó do n8n

Se você usa n8n, existe um nó oficial da Wevichat. Você instala, cola a chave e monta o fluxo arrastando blocos, sem escrever código.

É o caminho mais curto e o que recomendamos para quem não tem desenvolvedor à mão. Veja Conectar a Wevichat ao n8n.

2. Requisição HTTP em qualquer ferramenta

Make, Zapier, Pipedream, Power Automate e praticamente qualquer ferramenta de automação sabem fazer uma requisição HTTP. Como a nossa API é REST comum, todas funcionam sem código.

Configure o bloco de HTTP Request assim:

  • Método: POST ou GET, conforme o endpoint
  • URL: https://api.wevi.chat/functions/v1/<endpoint>
  • Header: Authorization: Bearer <sua-chave>
  • Content-Type: application/json
  • Corpo: o JSON que a documentação daquele endpoint pede

3. Código próprio

Se você tem desenvolvedor, ele chama a API direto. Para projetos em TypeScript ou JavaScript existe um pacote pronto que cuida da autenticação, da paginação e dos erros:

npm install @wevichat/sdk

Em qualquer outra linguagem, funciona com a biblioteca HTTP que o time já usa. A especificação da API está publicada, então dá para gerar o cliente automaticamente.

E se você só quer perguntar

Tem um quarto caminho, que não é integração: conectar o Claude, o ChatGPT ou o Cursor aos seus dados e perguntar em português. Veja Conversar com os seus dados pelo Claude ou pelo ChatGPT.

Como criar a chave

  1. Abra o app em app.wevi.chat.
  2. Clique no seu nome, no rodapé do menu lateral, para entrar em Minha conta.
  3. Vá na aba Desenvolvedores.
  4. Clique em Nova chave, dê um nome que lembre para onde ela vai ("n8n", "CRM", "site") e escolha o que ela pode fazer.
  5. Copie a chave na hora. Ela aparece uma única vez. Se perder, apague e crie outra.

Na mesma tela em que a chave aparece, há um comando já preenchido com ela e um botão que dispara a chamada ali mesmo, com a resposta logo abaixo. Clique antes de fechar: você sai da tela sabendo que a chave funciona.

A chave começa com wevi_ e vai em todas as chamadas, no cabeçalho:

Authorization: Bearer wevi_sua_chave

Crie uma chave por sistema, nunca uma para tudo. Assim, se um deles vazar ou sair do ar, você apaga só aquela e o resto continua funcionando.

Chave de teste

Ao criar a chave, marque Chave de teste. Ela sai com o prefixo wevi_test_ e muda uma coisa só: nada que você mandar com ela chega no WhatsApp de verdade.

Fora isso, tudo funciona igual. A resposta tem o mesmo formato, o envio fica registrado e os webhooks disparam de verdade, para você conferir se o seu lado está recebendo direito.

É com ela que você monta e testa a integração inteira sem gastar mensagem, sem incomodar cliente e sem medo de rodar duas vezes por engano. Quando estiver funcionando, troque pela chave normal.

Quando alguma coisa dá errado

Toda resposta da API traz um código chamado X-Request-Id. Guarde esse código.

Na aba Desenvolvedores existe a lista das últimas requisições da sua organização, com endpoint, resultado, tempo de resposta e o erro, dos últimos 7 dias. É lá que você vê se a chamada chegou e o que aconteceu com ela.

Se precisar abrir um chamado com o suporte, mande o X-Request-Id junto. É por ele que encontramos exatamente a sua chamada.

Dicas para um bom resultado

  • Comece pela chave de teste. Vale para qualquer integração, inclusive as que só leem dados.
  • Uma chave por sistema. Facilita revogar sem derrubar o resto.
  • Não coloque a chave dentro do código do seu site. Qualquer visitante consegue ler. Ela vive no servidor ou na ferramenta de automação. Veja Proteger a sua chave de API para as outras travas: validade, permissões e restrição por endereço.
  • Prefira receber aviso a ficar perguntando. Em vez de consultar a Wevichat de minuto em minuto para saber se chegou mensagem nova, configure um webhook e deixe que a gente avise. Veja Receber avisos de eventos.
  • Guarde o X-Request-Id nos seus logs. No dia em que algo falhar, você vai querer ter esse número.

E depois?

←

Anterior

Como usar o Webhook de Contatos

Próximo

Conectar a Wevichat ao n8n

→