SalesTouch Docs
Todas las herramientas MCP
Solo lecturaEmail

Conversaciones de correo

email_conversations

Lista y busca conversaciones de correo con leads en los buzones que puedes leer, de la más reciente a la más antigua. Filtra por needs_reply (el lead escribió el último), awaiting_reply, buzón, fecha o texto en asuntos, mensajes, remitentes y nombres de leads.

Cuándo usarla

Encuentra las conversaciones de correo que esperan respuesta o busca correos anteriores con leads en todos tus buzones.

Scopes necesarios
email:accesssalestouch:use
Ejecución
Llamada síncrona a una herramienta MCP

Requisitos

Conecta al menos un buzón; solo se guardan las conversaciones con leads.

Ejemplo

Pídeselo a tu agente

¿Qué leads respondieron a mis correos y aún esperan respuesta?

Argumentos de la herramienta
{
  "status": "needs_reply",
  "limit": 20
}
Envoltorio de respuesta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Conversaciones de la más reciente a la más antigua con el lead, el buzón, el indicador needs_reply, el número de mensajes y un extracto del último mensaje, además de next_cursor.

Parámetros

query
string

Texto comparado con asuntos, contenido de los mensajes, remitentes, nombres de leads y sus direcciones de correo.

status
string

all (predeterminado), needs_reply (el lead escribió el último) o awaiting_reply (tú escribiste el último).

account_id
string

Id o dirección del buzón devuelto por email_accounts. Por defecto, todos los buzones que puedes leer.

since
string

Solo conversaciones con actividad desde esta fecha ISO 8601.

limit
integer

Número máximo de conversaciones devueltas. Valor predeterminado: 20.

cursor
string

next_cursor devuelto por la página anterior, reutilizado con los mismos filtros.

Los alias se muestran por separado porque los clientes MCP envían un objeto JSON plano. Usa un solo alias de cada grupo obligatorio, no todos los alias.

Errores frecuentes

insufficient_scope

Vuelve a conectar el MCP y aprueba el permiso de LinkedIn solicitado.

paid_plan_required

Usa un espacio de trabajo de SalesTouch con acceso al MCP de LinkedIn.

trial_payment_method_required

Añade un método de pago en la facturación de SalesTouch para activar la prueba y el acceso al MCP de LinkedIn.

EMAIL_ACCOUNT_NOT_FOUND

Usa un id o una dirección de buzón devueltos por email_accounts.

INVALID_CURSOR

Empieza de nuevo sin cursor o reutiliza next_cursor tal como se devolvió.

En esta página

Cuándo usarlaRequisitosEjemploParámetrosErrores frecuentesHerramientas relacionadas