Obter Histórico de Conversas via WhatChimp API

Recupere o histórico completo de mensagens com qualquer assinante: mensagens enviadas, recebidas, carimbos de data/hora e status de entrega.

Updated 5 February 2026

Recupere o histórico completo de conversas com qualquer assinante: cada mensagem enviada e recebida, com carimbos de data/hora, informações do remetente e status de entrega.

Antes de começar: Certifique-se de ter sua chave API e ID do número de telefone. Consulte Primeiros Passos com WhatChimp Developer API para instruções de configuração.

Endpoint

GET/POST /api/v1/whatsapp/get/conversation

https://app.whatchimp.com/api/v1/whatsapp/get/conversation

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`apiToken`	String	Sim	Sua chave API do WhatChimp
`phone_number_id`	String	Sim	Seu ID de número de telefone do WhatsApp
`phone_number`	String	Sim	Número de telefone do assinante com código do país (ex., `919999999999`)
`limit`	Number	Sim	Número de mensagens a recuperar
`offset`	Number	Não	Deslocamento de paginação (começar a partir desta posição)

Exemplos de Requisição

GET:

https://app.whatchimp.com/api/v1/whatsapp/get/conversation?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID&phone_number=919999999999&limit=10&offset=1

POST (cURL):

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/get/conversation' \
  -d 'apiToken=API-KEY' \
  -d 'phone_number_id=PHONE-NUMBER-ID' \
  -d 'phone_number=919999999999' \
  -d 'limit=10' \
  -d 'offset=1'

Get Conversation endpoint showing parameters, request examples, and sample response in the API console

Resposta

{
  "status": "1",
  "message": [
    {
      "id": 8003,
      "sender": "bot",
      "agent_name": null,
      "message_content": "{...}",
      "conversation_time": "2024-07-28 13:21:03",
      "wa_message_id": "wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=",
      "message_status": "delivered",
      "delivery_status_updated_at": "2024-07-28 13:21:05"
    },
    {
      "id": 8004,
      "sender": "subscriber",
      "agent_name": null,
      "message_content": "Oi, preciso de ajuda com meu pedido",
      "conversation_time": "2024-07-28 13:25:10",
      "wa_message_id": "wamid.HBgNODgwMTcyMzMwOTAwMxUCABIYEjlGQkY3MEFEMEVGODhCNDkxNQA=",
      "message_status": null,
      "delivery_status_updated_at": null
    }
  ]
}

Campos da Resposta

Campo	Descrição
`id`	ID interno da mensagem
`sender`	Quem enviou a mensagem: `"bot"`, `"subscriber"`, ou o nome de um agente
`agent_name`	Nome do agente humano (se a mensagem foi enviada do Live Chat)
`message_content`	O texto da mensagem. Para mensagens do bot, isso é uma string JSON com a carga útil completa da mensagem
`conversation_time`	Carimbo de data/hora de quando a mensagem foi enviada
`wa_message_id`	ID da mensagem do WhatsApp: use isso com a Delivery Status API para rastrear a entrega
`message_status`	Status de entrega atual (`sent`, `delivered`, `read`, `failed`)
`delivery_status_updated_at`	Quando o status de entrega foi atualizado pela última vez

Paginação

Use limit e offset para paginar conversas longas:

# Primeiras 10 mensagens
?limit=10&offset=1

# Próximas 10 mensagens
?limit=10&offset=11

# Próximas 10
?limit=10&offset=21

Casos de Uso

Integração com CRM: sincronize o histórico de conversas em seu CRM ou sistema de suporte
Análises: analise tempos de resposta, volumes de mensagens e padrões de conversa
Trilha de auditoria: mantenha um registro de todas as interações com clientes
Depuração de chatbot: revise o que seu bot enviou versus o que o cliente respondeu