Wevichat | API

Documentação de API

Tudo que a Wevichat faz, disponível via API

Contatos, conversas, mensagens no WhatsApp, agentes de IA, campanhas e webhooks assinados. É a mesma API que o nosso próprio painel usa, então não existe recurso reservado para uso interno.

operações
103
rotas
85
eventos de webhook
30

A primeira chamada

Crie uma chave em Conta → Desenvolvedores no app e mande a requisição abaixo. Ela devolve a sua organização, o plano e o consumo do mês.

Marque chave de teste ao criar e a chave sai com o prefixo wevi_test_. Ela responde igual e dispara os webhooks de verdade, mas nunca envia nada no WhatsApp.

Começar pela introdução Autenticação
curl 
curl https://api.wevi.chat/functions/v1/org \
  -H "Authorization: Bearer wevi_SUA_CHAVE"
resposta
{
  "id": "746853d9-...",
  "name": "Odonto Vita",
  "plan": { "name": "Pro", "limits": { ... } },
  "usage": { "conversations_this_month": 412 }
}

Referência interativa

As 103 operações com todos os parâmetros, todas as respostas e exemplos prontos em curl, JavaScript, Python, PHP e mais. Gerada da mesma especificação que a API serve, então ela nunca fica atrás do que o servidor faz de verdade.

Wevi Dev, o agente que monta o payload com você

Descreva a integração do seu jeito ("quero mandar um template quando o pedido for pago") e ele devolve o endpoint, o escopo da chave, o JSON preenchido e a chamada pronta na sua linguagem. Ele consulta a mesma especificação que a API serve, então o payload sai no formato certo. Também ajuda a entender erro: cole o status e a resposta.

Guias por assunto

Começando

7 páginas

Autenticação, paginação, limites e o formato de erro que todo endpoint devolve.

Contatos

2 páginas

Cadastro, busca, etiquetas, campos próprios e sincronização a partir do seu sistema.

Conversas

2 páginas

Leia o histórico, assuma o atendimento, devolva para a IA e encerre.

Mensagens

10 páginas

Envio pelo WhatsApp: texto, template aprovado, botões, listas e catálogo.

Agentes

2 páginas

Converse com os seus agentes de IA direto pela API, sem passar pelo WhatsApp.

Campanhas

1 página

Dispare para uma lista de contatos e acompanhe o resultado.

Automações

2 páginas

Comece um fluxo automatizado quando algo acontece no seu sistema.

Webhooks

1 página

Receba eventos assinados no seu servidor, com reenvio automático em caso de falha.

Configuração

3 páginas

Números conectados, templates aprovados e metadados da organização.

Parceiros

1 página

Sistema

3 páginas

Dados da organização, consumo do mês, relatórios e verificação de disponibilidade.

Ferramentas

Wevi Dev

Agente de IA que conhece a API inteira. Diga o que você quer integrar e ele monta o endpoint, o payload e o código.

Referência interativa

Todos os endpoints com parâmetros, respostas e exemplos prontos.

OpenAPI

A API inteira descrita no formato OpenAPI. Aponte a sua ferramenta para ele e ela gera o cliente sozinha.

Coleção do Postman

Importe, preencha a chave e comece a chamar.

Arquivo .http

Para o REST Client do VS Code ou o cliente HTTP do JetBrains.

Nó do n8n

A API inteira arrastando blocos, com gatilho para os 30 eventos.

Servidor MCP

Dá ao Claude, ao ChatGPT ou ao Cursor acesso aos seus dados daqui.

SDK TypeScript

Paginação automática e erro tipado, sem dependência nenhuma.

Changelog

O que mudou na API, em ordem de data.

Travou em alguma coisa?

Toda resposta da API traz um header X-Request-Id. Guarde esse código e mande junto no chamado: é por ele que a gente encontra exatamente a sua chamada. O log das últimas requisições da sua organização fica em Conta → Desenvolvedores.

Para dúvida de payload ou de erro, o Wevi Dev responde na hora. Nunca cole a sua chave de API na conversa.