Obtener Historial de Conversación vía WhatChimp API

Recupera el historial completo de mensajes con cualquier suscriptor: mensajes enviados, recibidos, marcas de tiempo y estado de entrega.

Updated 5 February 2026

Recupera el historial completo de conversación con cualquier suscriptor: cada mensaje enviado y recibido, con marcas de tiempo, información del remitente y estado de entrega.

Antes de comenzar: Asegúrate de tener tu clave API y tu ID de número de teléfono. Consulta Primeros Pasos con WhatChimp Developer API para instrucciones de configuración.

Endpoint

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

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

Parámetros

Parámetro	Tipo	Requerido	Descripción
`apiToken`	String	Sí	Tu clave API de WhatChimp
`phone_number_id`	String	Sí	Tu ID de número de teléfono de WhatsApp
`phone_number`	String	Sí	Número de teléfono del suscriptor con código de país (ej., `919999999999`)
`limit`	Number	Sí	Número de mensajes a recuperar
`offset`	Number	No	Desplazamiento de paginación (comenzar desde esta posición)

Ejemplos de Solicitud

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

Respuesta

{
  "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": "Hola, necesito ayuda con mi pedido",
      "conversation_time": "2024-07-28 13:25:10",
      "wa_message_id": "wamid.HBgNODgwMTcyMzMwOTAwMxUCABIYEjlGQkY3MEFEMEVGODhCNDkxNQA=",
      "message_status": null,
      "delivery_status_updated_at": null
    }
  ]
}

Campos de Respuesta

Campo	Descripción
`id`	ID interno del mensaje
`sender`	Quién envió el mensaje: `"bot"`, `"subscriber"`, o el nombre de un agente
`agent_name`	Nombre del agente humano (si el mensaje fue enviado desde Live Chat)
`message_content`	El texto del mensaje. Para mensajes del bot, esto es una cadena JSON con la carga útil completa del mensaje
`conversation_time`	Marca de tiempo de cuando se envió el mensaje
`wa_message_id`	ID del mensaje de WhatsApp: úsalo con la Delivery Status API para rastrear la entrega
`message_status`	Estado de entrega actual (`sent`, `delivered`, `read`, `failed`)
`delivery_status_updated_at`	Cuándo se actualizó por última vez el estado de entrega

Paginación

Usa limit y offset para paginar conversaciones largas:

# Primeros 10 mensajes
?limit=10&offset=1

# Siguientes 10 mensajes
?limit=10&offset=11

# Siguientes 10
?limit=10&offset=21

Casos de Uso

Integración con CRM: sincroniza el historial de conversaciones en tu CRM o sistema de soporte
Análisis: analiza tiempos de respuesta, volúmenes de mensajes y patrones de conversación
Registro de auditoría: mantén un registro de todas las interacciones con clientes
Depuración de chatbot: revisa qué envió tu bot versus qué respondió el cliente