# Quickstart genérico

## Quando usar

Use este guia quando você quer integrar o ChatAgent em qualquer canal ou sistema que não deva nascer com cara de WhatsApp.

Exemplos:

- chat do site
- app
- CRM
- helpdesk
- webhook próprio
- automações

## Endpoint

```http
POST /api/messages
Authorization: Bearer SUA_API_KEY
Content-Type: application/json
```

## Contrato base

Você envia três blocos principais:

- `actor`
- `conversation`
- `message`

Exemplo:

```json
{
  "actor": {
    "id": "lead-42",
    "type": "lead",
    "name": "Maria"
  },
  "conversation": {
    "id": "site-chat:lead-42",
    "channel": "web"
  },
  "message": {
    "text": "Quero um orçamento"
  }
}
```

## O que cada parte quer dizer

- `actor`: quem está interagindo
- `conversation`: em qual conversa, sessão, caso ou ticket essa mensagem pertence
- `message`: o conteúdo atual que deve ser processado

## Exemplo de resposta

```json
{
  "reply": "Posso te ajudar com isso.",
  "conversation_id": "site-chat:lead-42",
  "thread_id": "conversation:web:site-chat:lead-42",
  "channel": "web",
  "actor_id": "lead-42",
  "credits_remaining": 123,
  "elapsed": 1.2,
  "status": "answered"
}
```

## Regra prática

Seu sistema:

1. traduz o evento para `actor + conversation + message`
2. chama `/api/messages`
3. lê `reply`
4. devolve `reply` ao canal original

## Observação sobre WhatsApp

`/api/whatsapp/message` continua existindo, mas agora deve ser tratado como um adaptador oficial de canal, não como o modelo principal da plataforma.