Documentação de API e integrações externas

Nível: Intermediário Tempo de leitura: 4 min Plano necessário: Todos os planos (alguns endpoints exigem Pro/Ultra)

Pra quem é

Pra quem vai integrar a Wevi com sistemas externos: CRM próprio, planilha, ferramentas no-code (Make, n8n, Zapier) ou scripts custom.

Se você só usa o painel da Wevi, não precisa ler. Esse artigo é o atalho pra desenvolvedor.

O hub de documentação

A referência técnica completa fica em wevi.chat/docs/api.

Lá você encontra:

Autenticação, rate limits, códigos de erro padronizados.
12+ endpoints REST documentados com schema, exemplos em curl/JavaScript.
Detalhes específicos de cada operação.

A central de ajuda (esta) tem artigos contextuais e tutoriais. A doc de API é referência técnica seca.

O que dá pra fazer pela API

Contatos:

Criar e atualizar contatos (com tags, campos personalizados, dono da carteira).
Buscar dados completos de um contato.
Descobrir programaticamente quais campos personalizados, tags e atendentes existem.
Adicionar/remover tags individualmente.
Atribuir e desatribuir donos de carteira.

Automações:

Disparar um fluxo de automação WhatsApp quando algo acontece no seu sistema.

Mensagens WhatsApp:

Enviar templates aprovados pelo Meta (com placeholders dinâmicos).
Enviar texto livre dentro da janela de 24h.
Enviar botões de resposta, listas, links com botão CTA.
Pedir localização do cliente.
Enviar cards de produto do catálogo Meta.

Monitoramento:

Endpoint público de health check pra Betterstack/Pingdom/UptimeRobot.

Credencial

Todos os endpoints usam a mesma credencial: uma API Key (wevi_*). Crie em Configurações → Desenvolvedores → API Keys e passe no header:

Authorization: Bearer wevi_sua_chave

A mesma chave funciona para contatos, automações, mensagens WhatsApp e qualquer outro endpoint. Veja Autenticação na doc técnica para detalhes.

URL base

Todos os endpoints estão em:

https://api.wevi.chat/functions/v1/<nome-do-endpoint>

Por exemplo:

https://api.wevi.chat/functions/v1/contacts (POST upsert / GET busca)
https://api.wevi.chat/functions/v1/send-template
https://api.wevi.chat/functions/v1/send-buttons
https://api.wevi.chat/functions/v1/health

Exemplo rápido: criar um contato pelo CRM

curl -X POST https://api.wevi.chat/functions/v1/contacts \
  -H "Authorization: Bearer wevi_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "cliente@exemplo.com",
    "name": "João Silva",
    "phone": "+5511999999999",
    "tags": ["Lead novo"],
    "assigned_user_email": "vendedor@suaempresa.com"
  }'

Pronto. Em segundos o contato aparece na Wevi com nome, telefone, tag e vendedor responsável.

Integrações no-code

Pra quem usa Make, n8n ou Zapier: como a API é REST padrão, qualquer um desses funciona sem custom code. Configure o nó de HTTP Request com:

Method: POST (ou GET, dependendo do endpoint)
URL: https://api.wevi.chat/functions/v1/<endpoint>
Authentication: Header Auth → Authorization: Bearer <sua-api-key>
Content-Type: application/json
Body: o JSON conforme a doc do endpoint

Próximos passos

Crie uma API Key em Configurações → Desenvolvedores → API Keys.
Abra wevi.chat/docs/api e comece pela Introdução.
Teste com o endpoint mais simples: `GET /health` (sem auth, só pra confirmar conectividade).

Dúvidas técnicas, mande pra suporte com o request_id do erro em mãos.

←

Como usar o Webhook de Contatos

Programa de Parceiros

→