Conversas

O Aillom MEX mantém o histórico completo de todas as conversas dos seus canais. Cada conversa agrupa as mensagens de um contato com um canal específico.

Listar Conversas

Retorna todas as conversas do Workspace com paginação:

curl "https://api.mex.aillom.com.br/api/conversations?limit=20&offset=0" \
  -H "Authorization: Bearer SEU_TOKEN"

Parâmetros de query:

Parâmetro	Tipo	Descrição
`limit`	number	Máximo de registros (padrão: 20)
`offset`	number	Offset para paginação
`channel`	string	Filtrar por canal: `whatsapp`, `telegram`, `instagram`, `webchat`
`agent_id`	string	Filtrar por Agente

Resposta:

{
  "data": [
    {
      "id": "uuid-da-conversa",
      "contact_name": "João Silva",
      "contact_phone": "+5511900000000",
      "channel": "whatsapp",
      "agent_id": "uuid-do-agente",
      "last_message": "Olá, preciso de ajuda!",
      "last_message_at": "2025-01-01T12:00:00Z",
      "conversation_vars": {
        "nome": "João Silva",
        "email": "joao@exemplo.com"
      },
      "created_at": "2025-01-01T10:00:00Z"
    }
  ],
  "total": 150,
  "limit": 20,
  "offset": 0
}

Buscar Conversa

curl https://api.mex.aillom.com.br/api/conversations/{id} \
  -H "Authorization: Bearer SEU_TOKEN"

Mensagens da Conversa

Retorna o histórico de mensagens de uma conversa específica:

curl "https://api.mex.aillom.com.br/api/conversations/{id}/messages?limit=50" \
  -H "Authorization: Bearer SEU_TOKEN"

Resposta:

{
  "data": [
    {
      "id": "uuid-msg",
      "role": "user",
      "content": "Olá, preciso de ajuda!",
      "created_at": "2025-01-01T12:00:00Z"
    },
    {
      "id": "uuid-msg-2",
      "role": "assistant",
      "content": "Olá! Como posso te ajudar hoje?",
      "created_at": "2025-01-01T12:00:05Z"
    }
  ],
  "total": 12
}

Encerrar Conversa

Encerra uma conversa ativa e libera o contexto de sessão:

curl -X POST https://api.mex.aillom.com.br/api/conversations/{id}/close \
  -H "Authorization: Bearer SEU_TOKEN"

Variáveis da Conversa

Acesse ou atualize as conversation_vars coletadas pelo agente:

# Consultar variáveis
curl https://api.mex.aillom.com.br/api/conversations/{id}/vars \
  -H "Authorization: Bearer SEU_TOKEN"

# Atualizar variáveis manualmente
curl -X PATCH https://api.mex.aillom.com.br/api/conversations/{id}/vars \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"nome": "Maria", "plano": "premium"}'

Para entender como o agente coleta e persiste essas variáveis automaticamente, veja Memória de Conversa.

Deletar Conversa

Remove permanentemente uma conversa e todas as suas mensagens:

curl -X DELETE https://api.mex.aillom.com.br/api/conversations/{id} \
  -H "Authorization: Bearer SEU_TOKEN"

⚠️ Esta operação é irreversível.