Publication

Publicación en LinkedIn

El componente Publication te permite compartir contenido en tu perfil o página de LinkedIn de forma automática. Es la herramienta ideal si quieres que Nappai se encargue de las redes sociales por ti, publicando noticias, actualizaciones o contenido multimedia sin tener que entrar manualmente a la plataforma.

Piensa en este componente como un asistente digital que toma la información que tú le proporcionas (texto, enlaces o imágenes) y la publica en el muro de LinkedIn en nombre de tu cuenta.

¿Cómo funciona?

Este componente actúa como un puente seguro entre tu sistema de automatización y LinkedIn. Funciona mediante una conexión API (Interfaz de Programación de Aplicaciones), que es el lenguaje estándar que utilizan dos sistemas de software para “hablar” entre sí.

El proceso interno es el siguiente:

1. Preparación: El componente toma los datos que ingresas (por ejemplo, el texto de tu publicación) y el tipo de archivo que quieres compartir.
2. Verificación: Comprueba que tienes permiso para publicar (usando tus credenciales de seguridad) y que el formato del contenido cumple con las reglas de LinkedIn.
3. Envío: Envía la solicitud al servidor de LinkedIn.
4. Confirmación: Si todo sale bien, LinkedIn devuelve un código de confirmación y guarda tu publicación. Si hay un error (como un enlace roto o falta de permisos), el componente te avisará para que puedas corregirlo.

Conexión y Credenciales

Importante: Para que este componente funcione, es necesario que hayas configurado previamente tu cuenta de LinkedIn en Nappai.

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio externo:

1. Dirígete a la sección de Credenciales en tu panel de Nappai.
2. Crea una nueva credencial del tipo LinkedIn API. Para esto necesitarás tener acceso a la Consola de Desarrolladores de LinkedIn para obtener tu Client Id y Client Secret.
3. En tu flujo de trabajo, selecciona la credencial que acabas de crear en el campo de entrada Credential de este nodo.

Nota: No necesitas configurar contraseñas o claves técnicas dentro de este componente; solo selecciona la credencial que ya guardaste.

Entradas

Los siguientes campos están disponibles para configurar este componente. Puedes utilizar valores fijos o conectar la salida de otros componentes (por ejemplo, extraer un título de un correo electrónico previo) para hacer tu flujo automático.

• Operation: Aquí seleccionarás la acción principal que deseas realizar. En la mayoría de los casos, esta sección se usa para elegir entre diferentes funciones de LinkedIn (como publicar, eliminar, etc.).

  • Visible en: [Selecciona la operación correspondiente]

• Type of publicacion: Define el formato del contenido que vas a publicar.

  • Visible en: [Selecciona la operación correspondiente]
  • Opciones:
    • Text: Publicación solo de texto.
    • Url: Publicación que incluye un enlace.
    • Image: Publicación con una imagen.
    • Video: Publicación con un video.

• Visibility: Controla quién puede ver tu publicación en la red social.

  • Visible en: [Selecciona la operación correspondiente]
  • Opciones:
    • Friends: Solo las personas conectadas a ti (tus contactos) podrán verlo.
    • Anyone: Cualquier persona en internet podrá verlo (público general).

• Title: Introduce el título de la publicación.

  • Visible en: [Selecciona la operación correspondiente]
  • Útil cuando publicas enlaces o artículos para dar contexto antes del enlace.

• Description: Introduce la descripción de la publicación a compartir.

  • Visible en: [Selecciona la operación correspondiente]
  • A menudo utilizado junto con imágenes o enlaces para dar más detalles.

• Url: Introduce la dirección web (URL) del enlace que deseas compartir.

  • Visible en: [Selecciona la operación correspondiente]
  • Este campo es obligatorio si el tipo de publicación es “Url”.

• Binary: Sube el archivo de imagen o video directamente desde tu ordenador o sistema.

  • Visible en: [Selecciona la operación correspondiente]
  • Se utiliza cuando el tipo de publicación es “Image” o “Video” y quieres subir el archivo en lugar de un enlace externo.

• Text of the post: Escribe el mensaje principal que aparecerá en tu perfil de LinkedIn.

  • Visible en: [Selecciona la operación correspondiente]
  • Este es el texto que tus seguidores leerán en su muro.

• Post ID: El identificador único de una publicación existente.

  • Visible en: [Selecciona la operación correspondiente]
  • Se utiliza principalmente si deseas eliminar una publicación anterior o realizar otras acciones sobre una publicación ya existente.

Salidas

Cuando el componente termina de procesar la solicitud, genera los siguientes resultados que puedes usar en pasos siguientes de tu automatización:

• Data: Contiene la información general de la respuesta de LinkedIn. Si la publicación fue exitosa, este campo te permitirá verificar el estado y guardar registros. En el caso de operaciones de publicación, aquí encontrarás detalles sobre la creación exitosa del contenido.

Ejemplo de Respuesta JSON

Si la publicación se realiza correctamente, el componente devuelve un JSON similar al siguiente. Puedes utilizar este ejemplo para entender qué datos estarás recibiendo para conectarlos a otros pasos (por ejemplo, para guardar el ID en una base de datos). json { “status”: “success”, “code”: 201, “message”: “Publication created successfully”, “data”: { “id”: “urn:li:share:7123456789012345678”, “author”: “urn:li:person:12345678”, “created”: 1698765432, “lastModified”: 1698765432 } }

Nota: El campo id dentro de data es muy importante si planeas eliminar o modificar esa publicación en el futuro.

Conectividad

Este componente es una acción final en la mayoría de los flujos.

• Conexión de Entrada: Generalmente se conecta a componentes que generan el contenido, como “Leer Email”, “Obtener datos de base de datos” o “Generar texto con IA”.
• Conexión de Salida: Suele ser el último paso. Sin embargo, puedes conectar su salida a un componente de “Registro” o “Notificación” (como un correo electrónico de confirmación) para saber que la publicación en LinkedIn se realizó correctamente.

Ejemplo de Uso

Escenario: Publicar un nuevo artículo del blog automáticamente

Imagina que quieres que cada vez que publicas un artículo en tu sitio web, aparezca automáticamente en tu LinkedIn.

1. Obtén el contenido: Un componente anterior extrae el título y la URL de tu sitio web.
2. Configura Publication:
   • En Operation, seleccionas “Publish”.
   • En Type of publicacion, eliges “Url”.
   • En Text of the post, escribes: “¡Nuevo artículo disponible! 📝 Lee aquí sobre automatización.”
   • En Url, arrastras la variable del enlace de tu artículo.
   • En Visibility, seleccionas “Anyone”.
   • En Credential, seleccionas tu cuenta de LinkedIn configurada.
3. Resultado: Al ejecutar el flujo, el componente enviará la solicitud a LinkedIn y publicarás el artículo sin tocar el mouse.

Consejos y Mejores Prácticas

• Verifica la Visibilidad: Asegúrate de elegir “Anyone” si quieres que tu contenido llegue a la mayor audiencia posible. “Friends” limita el alcance solo a tus conexes directas.
• Usa Credenciales Válidas: Si recibes un error de “401 Unauthorized”, significa que la credencial de LinkedIn que seleccionaste no tiene permisos válidos o ha caducado. Revisa la sección de credenciales en Nappai.
• Maneja Errores: Si la publicación falla, el componente no borrará automáticamente una publicación anterior. Es buena práctica añadir un paso de “Manejo de Errores” en tu flujo para notificar si la publicación no se realizó.
• Contenido Multimedia: Si subes imágenes o videos mediante el campo Binary, asegúrate de que los archivos no sean demasiado pesados, ya que LinkedIn tiene límites de tamaño para archivos subidos directamente.

Consideraciones de Seguridad

• Privacidad: Ten cuidado con el contenido que compartes. Una vez que una publicación es visible para “Anyone”, es difícil de restringir su distribución. Revisa el texto antes de ejecutar el flujo.
• Protección de Credenciales: Nunca compartas tus Client Id y Client Secret. Mantén estas credenciales seguras dentro de la sección de Credenciales de Nappai.
• Límites de la API: LinkedIn tiene límites en la cantidad de publicaciones que puedes hacer en un periodo corto de tiempo (rate limiting). Si tu flujo intenta publicar varias veces por segundo, es posible que la API rechace la solicitud. Añade pausas si automatizas publicaciones masivas.