Invitación de LinkedIn y después mensaje
linkedin_invite_then_messageEnvía ahora una invitación y, cuando el miembro la acepte, envía automáticamente un mensaje de seguimiento.
Cuándo usarla
Invita ahora a un miembro y envía automáticamente un seguimiento después de la aceptación.
linkedin:accesssalestouch:useRequisitos
Ejemplo
Invita a https://www.linkedin.com/in/example y, tras la aceptación, envía «Gracias por conectar.»
{
"linkedin_url": "https://www.linkedin.com/in/example",
"invite_message": "Would love to connect.",
"follow_up_message": "Thanks for connecting."
}{
"content": [
{
"type": "text",
"text": "{\n \"data\": { ... },\n \"meta\": null\n}"
}
],
"isError": false
}Resultado esperado: Estado de la invitación e identificador persistente del seguimiento.
Parámetros
account_idstringID, nombre de usuario, correo, identificador o URL de la cuenta de SalesTouch conectada.
identifierobligatoriostringIdentificador, 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.
invite_messagestringNota de invitación opcional.
follow_up_messagestringMensaje que se enviará cuando se acepte la invitación. Required unless follow_up_attachments are provided.
follow_up_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 seguimiento con adjuntos. Los seguimientos idénticos se deduplican de forma predeterminada.
retry_invitationbooleanAutorización expresa para otro intento tras un envío confirmado. Nunca omite resultados inciertos ni el plazo de 3 semanas registrado; no recorre todas las invitaciones.
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.
invitation_note_too_longMantén la nota por debajo de 300 caracteres (200 en cuentas gratuitas) o llama a retry_tool con retry_with para enviarla sin nota.
invitation_note_unavailableLa cuenta agotó sus invitaciones personalizadas. Llama a retry_tool con retry_with para enviar la invitación sin nota.
invitation_limit_reachedLa cuenta alcanzó el límite semanal de invitaciones de LinkedIn. Deja de invitar desde ella durante varios días; pon las invitaciones en cola o prográmalas.
invitation_already_pendingYa se envió una invitación. Consulta lead_status; no envíes otra.
invitation_requires_emailEste miembro solo acepta invitaciones de personas que conocen su correo. Contáctalo por otra vía.