Listar mensajes de un contacto

Recupera los mensajes de WhatsApp más recientes intercambiados con un contacto, a través de todas sus conversaciones.

GET/contacts/:uuid/messages

Autenticación

Este endpoint se autentica con tu API key enviada en la cabecera X-API-Key (formato ek_live_...). Puedes gestionar tus API keys desde la sección Dev Tools del panel.

Parámetros de ruta

ParámetroTipoObligatorioDescripción
uuidStringObligatorioUUID del contacto.

Parámetros de consulta

ParámetroTipoObligatorioDescripción
limitIntegerOpcionalCantidad de mensajes a devolver (por defecto 100, máximo 200).

Ejemplo de solicitud

bash
curl -X GET "https://eclectic-api-537143970188.us-central1.run.app/api/external/v2/contacts/eb2b914a-977e-4ab8-96e7-b886698b3eac/messages?limit=50" \
  -H "X-API-Key: ek_live_your_api_key_here"

Ejemplo de respuesta

json
{
  "messages": [
    {
      "uuid": "a1b2c3d4-0002-0000-0000-000000000000",
      "status": "sent",
      "channel": "whatsapp",
      "createdAt": "2024-09-24T11:32:05Z",
      "from": "56987654321",
      "to": "56912345678",
      "text": "Hi! How can we help?",
      "attachments": [],
      "metadata": {}
    },
    {
      "uuid": "a1b2c3d4-0001-0000-0000-000000000000",
      "status": "received",
      "channel": "whatsapp",
      "createdAt": "2024-09-23T20:09:10Z",
      "from": "56912345678",
      "to": "56987654321",
      "text": "Hello!",
      "attachments": [],
      "metadata": {}
    }
  ]
}

Notas

  • Los mensajes se devuelven del más reciente al más antiguo.
  • status es sent o received según la dirección del mensaje, o failed si la entrega falló.
  • Errores posibles: 400 (validación), 401 (API key inválida o ausente), 404 (contacto no encontrado).