Documentação · Desenvolvedores
Referência das APIs Evolink
Um painel, uma conta, três serviços. Cada chave de API nasce amarrada a um serviço — IA, WhatsApp ou integrações — e só fala com ele. Tudo gerenciado em /panel.
Serviço 01
API de IA
Gateway próprio em /v1, compatível com o formato [OI] — SDKs e código existente funcionam trocando apenas a URL base e a chave.
https://evolink.hostclube.com/v1 — autenticação por Authorization: Bearer com a chave de serviço IA gerada no painel. Chave de outro serviço recebe 403: uma chave de IA nunca fala com a API de WhatsApp, e vice-versa.
curl https://evolink.hostclube.com/v1/chat/completions \
-H "Authorization: Bearer sk-sua-chave-de-ia" \
-H "Content-Type: application/json" \
-d '{
"model": "modelo-do-catalogo",
"messages": [
{ "role": "user", "content": "Olá!" }
]
}'
# Lista de modelos do catálogo (playground no painel):
curl https://evolink.hostclube.com/v1/models \
-H "Authorization: Bearer sk-sua-chave-de-ia"| Endpoint | Descrição |
|---|---|
POST /v1/chat/completions | Chat no formato [OI] — streaming e não-streaming, uso medido por crédito. |
GET /v1/models | Catálogo de modelos disponíveis para a sua chave. |
GET /v1/models/{id} | Detalhe de um modelo (contexto, capacidades). |
/v1/openai/v1/… | Alias para SDKs que montam o path completo do formato [OI]. |
Créditos e uso
Cobrança por crédito: cada chamada debita tokens consumidos (entrada + saída) da carteira do cliente. Saldo, extrato e logs por chamada (modelo, tokens, latência, status) ficam no painel.
Playground
Teste modelos e parâmetros direto no painel antes de integrar — o playground usa a mesma infraestrutura da API, então o que funciona lá funciona no seu código.
Serviço 02
API de WhatsApp
Instância dedicada e autohospedada por cliente: fila com Redis, webhooks em tempo real e PostgreSQL 16 isolado. Sem limite por conversa e sem intermediário.
Pareamento por QR Code
A instância nasce no provisionamento da assinatura. No painel, escaneie o QR Code com o WhatsApp (comum ou Business) — a sessão fica ativa e reconecta sozinha se a conexão cair. Pareamento em cerca de 30 segundos.
Webhooks
Receba mensagens, status e eventos em tempo real no seu sistema: o endpoint aceita JSON, valida assinatura e registra log de entrega. Configuração e histórico no painel.
| Recurso | Como funciona |
|---|---|
Envio de mensagens | Texto, mídia e templates via API da instância — os endpoints completos ficam na página de detalhes da instância no painel, com exemplos em cURL, JavaScript e Python. |
Fila de envio | Toda saída passa pela fila Redis com intervalos configuráveis — respeita ritmo e reduz risco de bloqueio do número. |
Sessão | Persistida no seu banco com reconexão automática; histórico e mídias ficam na sua instância. |
Backup | Diário nos planos Pro; a cada 6 horas no Escala. |
Serviço 03
Fiscal Brasil
Consultas em tempo real e emissão de NFS-e Nacional — direto no painel ou via integração.
Consultas (sem certificado)
CNPJ, CPF, Simples Nacional, compliance e regimes tributários em tempo real. Due diligence de fornecedor com score de risco antes de fechar contrato. Validação de NF-e.
NFS-e Nacional (requer A1)
Emissão pelo padrão SEFIN/RFB com o certificado A1 ICP-Brasil da sua empresa: DPS montada e assinada XMLDSIG, transmissão mTLS e DANFSe gerado localmente — sem depender da API de PDF do governo.
Fundamentos
Conta e chaves
| Tema | Como funciona |
|---|---|
Login | Um login por e-mail para tudo: IA, WhatsApp e Fiscal no mesmo painel (/panel). |
Chaves | Cada chave nasce amarrada a um serviço. Gere, nomeie e revogue no painel — a chave nunca aparece em HTML de terceiros. |
Planos | Início, Pro e Escala — limites de números e mensagens por plano. Veja Preços. |
Dados | PostgreSQL, Redis, gateway de IA e APIs fiscais rodam na nossa infraestrutura, em containers isolados. Nenhuma conversa e nenhuma consulta sai dela além do próprio WhatsApp. |
Pronto para integrar?
Assine o serviço, gere a chave no painel e faça a primeira chamada no mesmo dia.