Skip to main content
GET

Descrição

Exporta mensagens de chat como um stream NDJSON (Newline-Delimited JSON) para análise qualitativa. Todos os IDs de pessoas são anonimizados automaticamente com HMAC-SHA256.
A resposta é um stream NDJSON (application/x-ndjson), não JSON padrão. Cada linha é um objeto JSON independente.

Header de autenticação

string
obrigatório
Sua API Key do Mindo. Aceita dois tipos:
  • Global (cross-company): mindo_global_<key> — acesso a todas as empresas
  • De empresa: mindo_xxxxxxxxxxxxxxxxxxxxxxxx — acesso limitado à empresa associada

Query parameters

string
obrigatório
ID da empresa. Aceita um inteiro ou lista separada por vírgulas: 42 ou 42,57.
string
obrigatório
Data/hora de início (ISO-8601, inclusivo). Exemplo: 2026-04-01T00:00:00Z.
string
obrigatório
Data/hora de fim (ISO-8601, exclusivo). Deve ser maior que from. Máximo de 31 dias de intervalo.
string
padrão:"all"
Filtro de plataforma: whatsapp, instagram, messenger, all.
string
Filtrar por agente IA. Um inteiro ou lista CSV: 5 ou 5,12.
string
padrão:"all"
Direção da mensagem: incoming, outgoing, all.
string
padrão:"classifications"
Campos extras a incluir (CSV): classifications, extractions, tool_calls, trace_id.
string
Cursor de paginação obtido de next_cursor na resposta anterior.
integer
padrão:"5000"
Quantidade máxima de linhas por chamada. Intervalo: 1–10000.

Resposta

A resposta é um stream NDJSON. Cada linha é um objeto JSON com os seguintes campos:
string
ID anonimizado da mensagem (msg_<24 hex chars>).
string
ID anonimizado do chat (conv_<24 hex chars>).
string
Timestamp ISO-8601 de quando a mensagem foi enviada.
string
Plataforma: META_WHATSAPP, WHATSAPP_EVOLUTION, INSTAGRAM, MESSENGER, MANYCHAT_WHATSAPP, MANYCHAT_INSTAGRAM.
string
"inbound" (do contato) ou "outbound" (do sistema/agente/operador).
object
Quem enviou a mensagem.
object
Dados do agente IA (somente se a mensagem foi gerada por um agente).
object
Conteúdo da mensagem.
object
Contexto da conversa.
object
Dados de exportação.

Campos opcionais (parâmetro include)

Estes campos só aparecem se solicitados no parâmetro include.
array
Classificações aplicadas à mensagem (incluído por padrão).
array
Dados extraídos da mensagem por extratores de campos personalizados.
array
Ferramentas executadas pelo agente IA durante a geração da mensagem.
string
ID de rastreamento no Langfuse para debugging. Só tem valor em mensagens outgoing geradas por um agente IA.

Paginação

A paginação é baseada em cursor. Se houver mais resultados, a última linha do stream é um sentinel:
Envie a próxima requisição com cursor=<next_cursor> para obter a página seguinte. Quando não há sentinel, todos os dados foram retornados.

Anonimização de IDs

A anonimização é determinística por empresa, irreversível e consistente entre exportações.

Mapeamento de canais

Erros mid-stream

Se ocorrer um erro após o stream já ter iniciado, ele é emitido como uma linha NDJSON adicional:

Limites

Casos de uso

Exportar apenas mensagens outgoing de um agente específico com tool_calls para avaliar quais ferramentas foram usadas e com qual sucesso:
Exportar mensagens incoming com suas classificações para avaliar ou retreinar modelos:
Exportar todas as mensagens de múltiplas empresas para auditoria comparativa:
Exportar mensagens com trace_id para correlacionar com rastreamentos no Langfuse: