> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deltalead.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar un mensaje humano — API REST de conversaciones

> Publicar un mensaje como asesor humano en una conversación abierta, sin pasar por la IA, y usar pause_ai para detener las respuestas automáticas del agente.

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

```text theme={null}
POST https://platform-api.deltalead.ai/v1/conversations/{id}/messages
```

## Parámetros de ruta

<ParamField path="id" type="string" required>
  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`.
</ParamField>

## Cuerpo de la solicitud

<ParamField body="content" type="string" required>
  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.
</ParamField>

<ParamField body="type" type="string" default="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`.
</ParamField>

<ParamField body="pause_ai" type="boolean" default="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`.
</ParamField>

## Solicitud de ejemplo

```bash cURL theme={null}
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.

```json 201 Created theme={null}
{
  "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

<ResponseField name="id" type="string">
  Identificador único del mensaje recién creado, con el prefijo `msg_`.
</ResponseField>

<ResponseField name="conversation_id" type="string">
  ID de la conversación a la que se envió el mensaje.
</ResponseField>

<ResponseField name="direction" type="string">
  Siempre `outbound` para los mensajes enviados por este endpoint.
</ResponseField>

<ResponseField name="type" type="string">
  Tipo de medio del mensaje, según lo indicado en la solicitud. Uno de `text`, `image`, `document`.
</ResponseField>

<ResponseField name="content" type="string">
  El contenido del mensaje tal como se envió: cuerpo de texto o URL del archivo multimedia.
</ResponseField>

<ResponseField name="sent_by" type="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.
</ResponseField>

<ResponseField name="created_at" type="string">
  Marca de tiempo ISO 8601 del momento en que se entregó el mensaje.
</ResponseField>

<Warning>
  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.
</Warning>