voltarAthelium · docs
Suporte técnico
Documentação

Webhook

Para ferramentas low-code que falam HTTP genérico — Zapier, Make, Power Automate, n8n, Activepieces. Use /api/v1/serve se quer resposta direta, ou /api/v1/compose se vai mandar o contexto pra outro LLM downstream.

Configuração genérica

  • URL: https://gateway.athelium.com.br/api/v1/serve
  • Método: POST
  • Headers: Authorization: Bearer sk-... + Content-Type: application/json
  • Body (JSON):
json
{
  "question": "Como qualifico um lead inbound?"
}

A resposta vem com answer (texto pronto pra enviar de volta ao usuário) e metadados de execução.

Zapier

Use o app Webhooks by Zapier → ação POST.

Webhooks by Zapier · POST
URL:    https://gateway.athelium.com.br/api/v1/serve
Method: POST
Headers:
  Authorization: Bearer <sua_api_key>
  Content-Type:  application/json
Data:
  question: << campo dinâmico do gatilho >>

Make (Integromat)

Módulo HTTP → Make a request.

Make · HTTP module
URL:    https://gateway.athelium.com.br/api/v1/serve
Method: POST
Body type: Raw
Content-Type: application/json
Headers:
  Authorization: Bearer <sua_api_key>
Body: { "question": "{{1.payload.text}}" }

Power Automate

Use a ação HTTP (premium connector).

Power Automate · HTTP
Method: POST
URI:    https://gateway.athelium.com.br/api/v1/serve
Headers:
  Authorization: Bearer <sua_api_key>
  Content-Type:  application/json
Body:
  { "question": "@{triggerOutputs()?['body/question']}" }

Resposta esperada

Após o POST, o body de resposta tem este shape (campos relevantes):

json
{
  "answer": "Para qualificar um lead inbound, aplique o framework BANT...",
  "execution_id": "...",
  "serve_execution_id": "...",
  "tokens_in": 1438,
  "tokens_out": 799,
  "latency_ms": 6672,
  "cached_compose": true
}

Mapeie answer pro próximo step da sua automação (envio WhatsApp, email, atualização de campo CRM, etc).

Limitações importantes

  • Timeout: a primeira chamada pode levar 20-30s (compose cold). Configure timeout do connector pra ≥60s.
  • Rate limit: 60 req/min/key. Se sua automação é high-volume, agrupe perguntas ou peça aumento.
  • Resposta longa: o campo answer pode passar de 4kb. Cheque o limite de payload do seu connector.

Quando usar /compose em vez de /serve

Use /compose quando você quer mandar o contexto pra outro modelo (GPT no OpenAI connector, por exemplo). O retorno tem composed_context em vez de answer. Você concatena no prompt do seu connector de LLM.

Próximos passos