Enviar un mensaje humano — API REST de conversaciones

Este endpoint envía un mensaje a una conversación activa en nombre de un vendedor humano, sin intervención del agente de IA. Es la opción indicada cuando un asesor de ventas necesita entrar en un momento crítico —una charla sobre financiación, una negociación de precio o el cierre de una operación— sin esperar a que la IA responda primero. De forma opcional se puede pausar el agente de IA en esa conversación para que no interfiera mientras el equipo maneja el intercambio de manera directa.

Endpoint

POST https://platform-api.deltalead.ai/v1/conversations/{id}/messages

Parámetros de ruta

string

requerido

Identificador único de la conversación a la que se envía el mensaje, por ejemplo conv_xyz789. La conversación debe tener el estado open.

Cuerpo de la solicitud

string

requerido

Cuerpo de texto del mensaje que se envía. Debe ser una cadena no vacía. El formato Markdown no se renderiza en el dispositivo del destinatario: conviene enviar texto plano.

string

predeterminado:"text"

Tipo de medio del mensaje. Valores aceptados: text, image, document. Para image y document, content debe ser una URL de acceso público al archivo. El valor por defecto es text.

boolean

predeterminado:"false"

Con true, el agente de IA queda pausado en esta conversación inmediatamente después de enviar el mensaje. La IA no genera más respuestas automáticas hasta que se la reanude desde el panel de DeltaLead o mediante el endpoint de reanudación de la API. El valor por defecto es false.

Solicitud de ejemplo

cURL

curl -X POST https://platform-api.deltalead.ai/v1/conversations/conv_xyz789/messages \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Hi María, I'\''m your sales advisor. Let me check the financing options for you.", "pause_ai": true}'

Respuesta

Una solicitud correcta devuelve 201 Created con el objeto del mensaje creado.

201 Created

{
  "id": "msg_005",
  "conversation_id": "conv_xyz789",
  "direction": "outbound",
  "type": "text",
  "content": "Hi María, I'm your sales advisor. Let me check the financing options for you.",
  "sent_by": "human",
  "created_at": "2024-03-11T09:05:33Z"
}

Campos de la respuesta

string

Identificador único del mensaje recién creado, con el prefijo msg_.

string

ID de la conversación a la que se envió el mensaje.

string

Siempre outbound para los mensajes enviados por este endpoint.

string

Tipo de medio del mensaje, según lo indicado en la solicitud. Uno de text, image, document.

string

El contenido del mensaje tal como se envió: cuerpo de texto o URL del archivo multimedia.

string

Siempre human para los mensajes enviados por este endpoint, lo que permite distinguirlos de las respuestas generadas por IA dentro del historial de la conversación.

string

Marca de tiempo ISO 8601 del momento en que se entregó el mensaje.

Enviar un mensaje con pause_ai: true detiene de inmediato las respuestas automáticas del agente de IA en esta conversación. El lead no recibe ninguna otra respuesta automatizada hasta que la IA se reanude. Para reanudar el agente de IA, se puede usar el control de reanudación del panel de DeltaLead —abrir la conversación y activar la opción para reanudar la IA— o llamar al endpoint de reanudación de la API. Dejar la IA pausada en un día de alto volumen puede derivar en leads perdidos, así que conviene reanudar el agente apenas termina la intervención manual.

Introducción

Leads

Conversaciones

Agentes

Webhooks

Enviar un mensaje humano — API REST de conversaciones

Endpoint

Parámetros de ruta

Cuerpo de la solicitud

Solicitud de ejemplo

Respuesta

Campos de la respuesta

​Endpoint

​Parámetros de ruta

​Cuerpo de la solicitud

​Solicitud de ejemplo

​Respuesta

​Campos de la respuesta

Endpoint

Parámetros de ruta

Cuerpo de la solicitud

Solicitud de ejemplo

Respuesta

Campos de la respuesta