SalesTouch Docs
Todas las herramientas MCP
Envía correosEmail

Enviar correo

email_send

Envía un correo personal 1:1 desde el buzón conectado del propio usuario, como hilo nuevo o como respuesta. Los envíos respetan los límites diarios, el calentamiento y el horario laboral del buzón; los envíos en cola indican scheduled_for. Una respuesta por cualquier canal cancela la prospección en cola anterior a ella, salvo que stop_on_reply sea false. No sirve para newsletters ni envíos masivos.

Cuándo usarla

Envía un correo personal a un lead desde tu propio buzón o responde en un hilo de correo existente.

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

Requisitos

Indica lead_id o to.
Indica body y, para un hilo nuevo, subject.
account_id es opcional: SalesTouch elige el buzón ya usado con el lead y, si no hay, el que tiene más capacidad diaria libre.
Establece queue en true, o indica scheduled_for, para esperar al siguiente hueco de envío libre en lugar de fallar al llegar al límite diario.

Ejemplo

Pídeselo a tu agente

Envía a Ada un breve seguimiento por correo sobre la demo de la semana pasada y ponlo en cola dentro de mis límites de envío.

Argumentos de la herramienta
{
  "lead_id": "lead_example",
  "subject": "Following up on the demo",
  "body": "Hi Ada,\n\nThanks again for your time last week. Would a short call on Thursday work?\n\nBest,",
  "queue": true
}
Envoltorio de respuesta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Un resultado enviado con los ids del hilo y del mensaje, o un resultado en cola con queued_action_id y scheduled_for.

Parámetros

account_id
string

Id o dirección de correo de un buzón conectado devuelto por email_accounts. Por defecto: el buzón ya usado con el lead y, si no hay, el que tiene más capacidad diaria libre.

lead_id
string

ID canónico del lead de SalesTouch devuelto por lead_status or leads_search.

to
string

Dirección de correo del destinatario. Obligatoria sin lead_id; con lead_id se asocia a ese lead.

first_name
string

Nombre del destinatario, guardado cuando la dirección crea un lead nuevo.

last_name
string

Apellido del destinatario, guardado cuando la dirección crea un lead nuevo.

subject
string

Asunto del correo. Obligatorio para un hilo nuevo; las respuestas reutilizan el asunto del hilo.

bodyobligatorio
string

Cuerpo del correo en texto sin formato. Se añade la firma del buzón.

reply_to_thread_id
string

Id del hilo de correo devuelto por email_threads. La respuesta se envía desde el buzón de ese hilo.

stop_on_reply
boolean

Omite este correo en cola si el lead responde por cualquier canal antes del envío. Valor predeterminado: true.

scheduled_for
string

Fecha y hora ISO 8601 futura con zona horaria. La acción nunca se ejecutará antes de ese momento y se pondrá en cola de forma implícita.

queue
boolean

Establécelo en true para poner esta acción en cola cuando no pueda ejecutarse ahora.

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.

action_limit_queue_required

Repite la llamada con queue establecido en true.

email_account_required

Conecta un buzón en la configuración de SalesTouch y vuelve a intentarlo.

email_reconnect_required

Vuelve a conectar el buzón en la configuración de SalesTouch y reinténtalo.

lead_email_missing

Importa una dirección de correo para el lead con leads_import o indica to.

email_recipient_suppressed

No lo reintentes: esta dirección ya rebotó. Busca otra dirección para el lead.