Empieza gratis

Referencia de la API

Importación de conversaciones

Trae el historial de conversaciones de otra herramienta a la bandeja, hasta 200 por llamada, sin enviar ningún mensaje, sin cobro y sin duplicados.

  • 1 operación
  • URL basehttps://api.messages.ccxcompany.co
  • AutenticaciónBearer con tu clave de API

El texto técnico de abajo viene del contrato público, openapi.json, en el idioma en que se escribió el contrato.

Import historical conversations into the Inbox

POST/conversations/import

Bulk-imports historical conversations (up to 200 per request) with their text messages, writing Conversation + Message documents directly — no message is sent, nothing is charged. Idempotent per (numberId, contactPhone): an existing conversation for that number+phone is skipped, never duplicated. Message at is the original timestamp, so history sorts correctly in the Inbox.

Respuestas

  • 200Default Response

    Campos y ejemplo de la respuesta
    JSON
    {}
  • 401RFC 7807 problem details for UNAUTHORIZED (401).

  • 403RFC 7807 problem details for FORBIDDEN (403).

  • 422RFC 7807 problem details for VALIDATION_ERROR (422).

Las respuestas de error siguen el formato RFC 7807 (application/problem+json), con un código estable en el campo code. Ver los códigos de error

Ejemplo en curl

cURL
curl -X POST 'https://api.messages.ccxcompany.co/conversations/import' \  -H "Authorization: Bearer $CCX_API_KEY"
Solo los campos obligatorios. Cambia los valores de ejemplo por los tuyos.

¿Atascado en una ruta? Habla con quienes mantienen la API.

Si creas la cuenta desde la web, recibes 5 US$ de crédito de prueba.