Mensaje de LinkedIn
linkedin_messageEnvía un mensaje directo de LinkedIn a un miembro objetivo.
Cuándo usarla
Envía un mensaje directo a una conexión existente de LinkedIn o a una conversación conocida.
linkedin:accesssalestouch:useRequisitos
Ejemplo
Envía «Gracias por conectar, encantado de intercambiar ideas.» a https://www.linkedin.com/in/example.
{
"linkedin_url": "https://www.linkedin.com/in/example",
"text": "Thanks for connecting, happy to compare notes.",
"queue": true
}{
"content": [
{
"type": "text",
"text": "{\n \"data\": { ... },\n \"meta\": null\n}"
}
],
"isError": false
}Resultado esperado: Un resultado de mensaje enviado o en cola con su identificador de acción.
Parámetros
account_idstringID, nombre de usuario, correo, identificador o URL de la cuenta de SalesTouch conectada.
identifierstringIdentificador, ID público, ID de cuenta o URL de perfil del miembro de LinkedIn.
queuebooleanEstablécelo en true para poner esta acción en cola cuando no pueda ejecutarse ahora.
scheduled_forstringFecha 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.
textstringTexto del mensaje que se enviará. Required unless attachments are provided.
attachmentsarrayAdjuntos nativos: hasta 5 archivos y 60 MB en total. Usa un attachment_id subido, una URL HTTPS pública o bytes base64; el base64 en línea está limitado a 3 MB por solicitud, así que envía los archivos más grandes por url o attachment_id. No se admiten rutas locales ni HTML. Sube los archivos seleccionados mediante /api/linkedin/attachments en la aplicación y pasa su attachment_id.
idempotency_keystringClave estable del mensaje con adjuntos, de hasta 120 caracteres. La misma clave y contenido nunca generan dos envíos. Sin clave se deduplican mensajes idénticos; cámbiala deliberadamente solo para un envío nuevo.
linkedin_conversation_idstringID opcional de una conversación existente de LinkedIn. conversation_id está reservado para la sesión de análisis MCP.
bypass_rate_limitbooleanAnular el comportamiento de cola según las respuestas. Los mensajes a leads que ya respondieron omiten de forma predeterminada los límites de envíos en cola, salvo que se defina queue o scheduled_for.
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_scopeVuelve a conectar el MCP y aprueba el permiso de LinkedIn solicitado.
paid_plan_requiredSigue la action_url del error: inicia la prueba gratuita, elige un plan si la prueba o la suscripción terminó, o actualiza el método de pago tras un pago fallido. details.reason indica el caso.
trial_payment_method_requiredReintenta en un minuto si acabas de completar el pago; si no, 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_requiredRepite la llamada con queue establecido en true.
message_requires_connectionEl miembro no es un contacto de 1.er grado y la cuenta no puede enviarle un InMail. Llama a retry_tool (linkedin_invite_then_message) con retry_with; no reintentes linkedin_message.
inmail_credits_exhaustedLa cuenta no tiene créditos de InMail. Usa linkedin_invite_then_message o espera a que se recarguen los créditos.
message_too_longAcorta el texto y vuelve a enviarlo.
recipient_unreachableLinkedIn no entregará mensajes a este miembro desde esta cuenta. No lo reintentes.