Webhooks & Integracoes

Base da API: https://api.starchat.app/v1 · autenticacao via header x-api-key.

API Keys

StarGestor - Producao

sk_star_gestor_9f2a••••••••4c71

contacts, conversations, messages

criada 12/03/2026

StarLaudo - Webhook

sk_star_laudo_1b83••••••••7de0

messages:send, tickets

criada 28/05/2026

Webhooks de saida

https://api.stargestor.com.br/hooks/starchat

active

message.received

lead.created

https://api.starlaudo.com.br/webhooks/tickets

active

ticket.closed

https://n8n.meudominio.com.br/webhook/starchat

paused

message.received

ticket.closed

lead.created

Payload de exemplo

{
  "event": "message.received",
  "organization_id": "8f14e45f-ceea-467a-9b1e-7d1b1f2a30c1",
  "instance": { "provider": "evolution", "name": "recepcao-01" },
  "contact": { "name": "Marina Alves", "phone": "+5511998124477", "document": "482.119.330-11" },
  "conversation_id": "1c0b8f4a-1f47-4d2e-a2c9-0f9d0a1b2c3d",
  "message": { "kind": "text", "body": "Consegue me enviar o laudo?" },
  "sent_at": "2026-08-28T15:04:11Z"
}

Endpoints principais

POST /v1/messages · envia texto, midia ou template
GET /v1/conversations?status=open
POST /v1/contacts · upsert por telefone + documento
PATCH /v1/conversations/:id · etapa, fila, atendente