Invitación de LinkedIn
linkedin_inviteEnvía una invitación de linkedin directamente tras resolver la identidad y obtener un bloqueo persistente por destinatario. Los ids de perfil conocidos no requieren comprobar el perfil ni recorrer las invitaciones salientes. Gestiona expresamente los rechazos del proveedor; un plazo de 3 semanas no demuestra que ya haya una invitación pendiente. Los envíos confirmados requieren autorización expresa para reenviar. Los resultados inciertos bloquean los reintentos.
Cuándo usarla
Envía una invitación para conectar en LinkedIn, opcionalmente con una nota breve.
linkedin:accesssalestouch:useRequisitos
Ejemplo
Invita a https://www.linkedin.com/in/example a conectar con la nota «Me encantaría conectar.»
{
"linkedin_url": "https://www.linkedin.com/in/example",
"message": "Would love to connect.",
"queue": true
}{
"content": [
{
"type": "text",
"text": "{\n \"data\": { ... },\n \"meta\": null\n}"
}
],
"isError": false
}Resultado esperado: Un resultado de invitación enviada o en cola.
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.
textstringNota de invitación opcional.
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.
action_limit_queue_requiredRepite la llamada con queue establecido en true.
invitation_cooldownNo reintentes automáticamente. Consulta lead_status para distinguir una invitación pendiente de una solicitud gestionada recientemente; un reenvío posterior requiere autorización expresa.
invitation_status_unknownConsulta lead_status de nuevo. No envíes ni reintentes automáticamente mientras invitation_status sea unknown.
invitation_outcome_unknownConsulta lead_status de nuevo. No envíes ni reintentes automáticamente mientras invitation_status sea unknown.
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.