DocumentaciónReferencia de la API

Conversaciones

Las conversaciones del espacio o de un sitio, sus mensajes, y cómo enviar uno.

Cada operación de esta página es también una herramienta MCP, con el mismo nombre. Las marcadas Gratis no cuestan nada; las marcadas De pago usan los créditos del espacio, como en la aplicación (Cuánto cuesta).

OperaciónLlamada
Modificar una conversaciónPATCH /conversations/{cid}Gratis
Eliminar una conversaciónDELETE /conversations/{cid}Gratis
Listar las conversacionesGET /conversationsGratis
Crear una conversaciónPOST /conversationsGratis
Obtener una conversaciónGET /conversations/{cid}Gratis
Listar los mensajesGET /conversations/{cid}/messagesGratis
Enviar un mensajePOST /conversations/{cid}/messagesDe pago
Listar los documentos de una conversaciónGET /conversations/{cid}/documentsGratis
Listar las conversaciones de un sitioGET /sites/{siteId}/conversationsGratis
Crear una conversación en un sitioPOST /sites/{siteId}/conversationsGratis
Obtener una conversación de un sitioGET /sites/{siteId}/conversations/{cid}Gratis
Listar los mensajes de un sitioGET /sites/{siteId}/conversations/{cid}/messagesGratis
Enviar un mensaje en un sitioPOST /sites/{siteId}/conversations/{cid}/messagesDe pago

Modificar una conversación

PATCH/conversations/{cid}Gratis

Renombra una conversación, o la marca o desmarca con una estrella.

  • Actúa sobre cualquier conversación del espacio, incluidas las de un sitio (basta con su cid), como hace la aplicación.
  • Solo cambian los campos indicados. Responde con la conversación.

Herramienta MCP update_conversation

ArgumentoTipoDescripción
ciden la rutastringSu id.
titleopcionalstringRenombra la conversación.1–500 caracteres
starredopcionalbooleantrue la marca con una estrella (starred_at = ahora), false se la quita.
Petición
curl -X PATCH https://app.semchat.io/api/v1/conversations/{cid} \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "…"}'

Responde 200 con { "data": … }.

Eliminar una conversación

DELETE/conversations/{cid}Gratis

Elimina una conversación.

  • Actúa sobre cualquier conversación del espacio, incluidas las de un sitio (basta con su cid), como hace la aplicación.
  • Borrado lógico, como en la aplicación: sale de las listas y responde 404; sus mensajes y los datos guardados a partir de ella se conservan.

Herramienta MCP delete_conversation

ArgumentoTipoDescripción
ciden la rutastringSu id.
Petición
curl -X DELETE https://app.semchat.io/api/v1/conversations/{cid} \
  -H "Authorization: Bearer sk_live_…"

Responde 200 con { "data": … }.

Listar las conversaciones

GET/conversationsGratis

Las conversaciones del espacio (no vinculadas a un sitio).

Herramienta MCP list_conversations

Petición
curl https://app.semchat.io/api/v1/conversations \
  -H "Authorization: Bearer sk_live_…"
Respuesta · 200
{
  "data": [
    {
      "id": "01a163c9-4920-773f-89fb-75ff608e07fe",
      "title": "Audit complet d'alpha",
      "site_id": null,
      "message_count": 2,
      "starred_at": "2026-10-22T13:31:58.000Z",
      "last_message_at": "2026-10-22T13:26:58.000Z",
      "created_at": "2026-10-22T13:24:58.000Z",
      "updated_at": "2026-10-22T13:26:58.000Z"
    },
    {
      "id": "01a15ea2-ed20-7a5d-a415-afcd68358a91",
      "title": "Idées de contenu",
      "site_id": null,
      "message_count": 2,
      "starred_at": "2026-10-21T13:31:58.000Z",
      "last_message_at": "2026-10-21T13:26:58.000Z",
      "created_at": "2026-10-21T13:24:58.000Z",
      "updated_at": "2026-10-21T13:26:58.000Z"
    }
  ]
}

Crear una conversación

POST/conversationsGratis

Empieza una conversación del espacio.

Herramienta MCP create_conversation

ArgumentoTipoDescripción
titleopcionalstringSu título (opcional).hasta 500 caracteres
Petición
curl -X POST https://app.semchat.io/api/v1/conversations \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "…"}'

Responde 201 con { "data": … }.

Obtener una conversación

GET/conversations/{cid}Gratis

Una conversación del espacio (incluidas las de un sitio).

Herramienta MCP get_conversation

ArgumentoTipoDescripción
ciden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/conversations/{cid} \
  -H "Authorization: Bearer sk_live_…"
Respuesta · 200
{
  "data": {
    "id": "01a163c9-4920-773f-89fb-75ff608e07fe",
    "title": "Audit complet d'alpha",
    "site_id": null,
    "message_count": 2,
    "starred_at": "2026-10-22T13:31:58.000Z",
    "last_message_at": "2026-10-22T13:26:58.000Z",
    "created_at": "2026-10-22T13:24:58.000Z",
    "updated_at": "2026-10-22T13:26:58.000Z"
  }
}

Listar los mensajes

GET/conversations/{cid}/messagesGratis

Los mensajes de una conversación del espacio, del más antiguo al más reciente (texto, llamadas a herramientas y sus resultados, gráficos, documentos).

Herramienta MCP list_messages

ArgumentoTipoDescripción
ciden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/conversations/{cid}/messages \
  -H "Authorization: Bearer sk_live_…"
Respuesta · 200
{
  "data": [
    {
      "id": "01a15456-3520-7803-9dfd-670569df332f",
      "role": "user",
      "content": "C'est quoi le SEO ?",
      "parts": [
        "…"
      ],
      "created_at": "2026-10-19T13:24:58.272Z"
    },
    {
      "id": "01a15456-aa50-78f0-8c72-120a580ca098",
      "role": "assistant",
      "content": "Le référencement naturel.",
      "parts": [
        "…",
        "…"
      ],
      "created_at": "2026-10-19T13:25:28.272Z"
    }
  ]
}

Enviar un mensaje

POST/conversations/{cid}/messagesDe pago

Envía un mensaje: el asistente responde usando sus herramientas (datos de palabras clave, rastreo, competidores…) como en la aplicación.

  • Los adjuntos se guardan como en la aplicación (cualquier miembro del espacio; un tipo no admitido o un archivo de más de 20 MB es INVALID_INPUT) y llegan al asistente con el mensaje. Una petición pesa 25 MB como máximo: unos 18 MB de archivos una vez codificados en base64.
  • La API envía la respuesta en streaming como Server-Sent Events («UI message stream» del Vercel AI SDK); cuando termina, léela completa con la lista de mensajes. Por MCP, la herramienta espera al final y devuelve la respuesta.
  • Se factura en créditos exactamente como un turno de chat en la aplicación.

Herramienta MCP send_message

ArgumentoTipoDescripción
ciden la rutastringSu id.
messageobligatoriostringEl mensaje del usuario.al menos 1 carácter
attachmentsopcionalarrayArchivos adjuntos al mensaje, como en la aplicación (los mismos tipos, 20 MB cada uno como máximo).
streamopcionalbooleanSe acepta por compatibilidad; la respuesta de la API siempre llega en streaming.
Petición
curl -X POST https://app.semchat.io/api/v1/conversations/{cid}/messages \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"message": "…"}'

La respuesta llega en streaming como Server-Sent Events; cuando termina, léela completa con la lista de mensajes. Por MCP, la herramienta espera al final y devuelve la respuesta.

Listar los documentos de una conversación

GET/conversations/{cid}/documentsGratis

Los documentos escritos en una conversación del espacio.

Herramienta MCP list_conversation_documents

ArgumentoTipoDescripción
ciden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/conversations/{cid}/documents \
  -H "Authorization: Bearer sk_live_…"

Responde 200 con { "data": … }.

Listar las conversaciones de un sitio

GET/sites/{siteId}/conversationsGratis

Las conversaciones de un sitio.

Herramienta MCP list_site_conversations

ArgumentoTipoDescripción
siteIden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/sites/{siteId}/conversations \
  -H "Authorization: Bearer sk_live_…"

Responde 200 con { "data": … }.

Crear una conversación en un sitio

POST/sites/{siteId}/conversationsGratis

Empieza una conversación en un sitio: el asistente conoce ese sitio.

Herramienta MCP create_site_conversation

ArgumentoTipoDescripción
siteIden la rutastringSu id.
titleopcionalstringSu título (opcional).hasta 500 caracteres
Petición
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/conversations \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "…"}'

Responde 201 con { "data": … }.

Obtener una conversación de un sitio

GET/sites/{siteId}/conversations/{cid}Gratis

Una de las conversaciones de un sitio.

Herramienta MCP get_site_conversation

ArgumentoTipoDescripción
siteIden la rutastringSu id.
ciden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/sites/{siteId}/conversations/{cid} \
  -H "Authorization: Bearer sk_live_…"

Responde 200 con { "data": … }.

Listar los mensajes de un sitio

GET/sites/{siteId}/conversations/{cid}/messagesGratis

Los mensajes de una conversación de un sitio, del más antiguo al más reciente.

Herramienta MCP list_site_messages

ArgumentoTipoDescripción
siteIden la rutastringSu id.
ciden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/sites/{siteId}/conversations/{cid}/messages \
  -H "Authorization: Bearer sk_live_…"

Responde 200 con { "data": … }.

Enviar un mensaje en un sitio

POST/sites/{siteId}/conversations/{cid}/messagesDe pago

Envía un mensaje en una conversación de un sitio: el asistente responde teniendo en cuenta ese sitio.

  • Los adjuntos se guardan como en la aplicación (cualquier miembro del espacio; un tipo no admitido o un archivo de más de 20 MB es INVALID_INPUT) y llegan al asistente con el mensaje. Una petición pesa 25 MB como máximo: unos 18 MB de archivos una vez codificados en base64.
  • La API envía la respuesta en streaming como Server-Sent Events («UI message stream» del Vercel AI SDK); cuando termina, léela completa con la lista de mensajes. Por MCP, la herramienta espera al final y devuelve la respuesta.
  • Se factura en créditos exactamente como un turno de chat en la aplicación.

Herramienta MCP send_site_message

ArgumentoTipoDescripción
siteIden la rutastringSu id.
ciden la rutastringSu id.
messageobligatoriostringEl mensaje del usuario.al menos 1 carácter
attachmentsopcionalarrayArchivos adjuntos al mensaje, como en la aplicación (los mismos tipos, 20 MB cada uno como máximo).
streamopcionalbooleanSe acepta por compatibilidad; la respuesta de la API siempre llega en streaming.
Petición
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/conversations/{cid}/messages \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"message": "…"}'

La respuesta llega en streaming como Server-Sent Events; cuando termina, léela completa con la lista de mensajes. Por MCP, la herramienta espera al final y devuelve la respuesta.

¿No encuentras la respuesta? Escríbenos.

¿Listo para impulsar tu web?

Haz tu primera pregunta - semchat te responde con un plan de acción claro en segundos.

Gratis · sin registro · en 5 segundos