Los nodos de listado de Poli son responsables de buscar y organizar información ya registrada en el sistema, como cuentas, canales, usuarios, contactos, mensajes, equipos, plantillas, etiquetas, apps y webhooks.
Estos nodos son muy útiles cuando necesitas consultar datos antes de realizar una acción o cuando deseas automatizar flujos que dependen de información específica (por ejemplo: buscar un contacto para luego enviar un mensaje).

En este tutorial, comprenderás:

• Qué nodos de listado están disponibles actualmente.
• Qué hace cada nodo.
• Qué parámetros o identificadores son necesarios para que el nodo funcione.
• Cómo obtener los identificadores más usados: account_uuid y contact_uuid.

⚠ Atención: Antes de usar cualquier nodo de listado, es obligatorio tener un token de acceso. Este token se utilizará en todas las solicitudes. Si aún no tienes uno, consulta cómo generar y guardar el tuyo en este enlace/tutorial.

Nodos de Listado Disponibles en n8n

Actualmente, hay 10 nodos de listado. A continuación, explico en detalle la funcionalidad de cada uno y los requisitos para usarlos:

1. Listar Cuentas (List Accounts)

• Función: Devuelve todas las empresas (cuentas) vinculadas al token del usuario.
• Parámetro requerido: Solo el token.

2. Listar Canales (List Channels)

• Función: Devuelve todos los canales de comunicación vinculados a una empresa específica.
• Parámetro requerido: Account UUID.

3. Listar y Buscar Usuarios (List and Search Users)

• Función: Lista todos los usuarios vinculados a una empresa.
• Parámetro requerido: Account UUID.

4. Listar Mensajes por Contacto (List Messages from Contact ID)

• Función: Lista todos los mensajes vinculados a un contacto específico.
• Parámetro requerido: Contact UUID.

5. Listar y Buscar Contactos (List and Search Contacts)

• Función: Devuelve todos los contactos de una empresa, junto con sus respectivos UUIDs.
• Parámetro requerido: Account UUID.

6. Listar Equipos (List Teams)

• Función: Devuelve todos los equipos/departamentos vinculados a una empresa.
• Parámetro requerido: Account UUID.

7. Listar Plantillas (List Templates)

• Función: Devuelve todas las plantillas creadas en la empresa.
• Aplicación práctica: Estas plantillas se utilizan posteriormente para enviar mensajes vía WhatsApp u otros canales.
• Parámetro requerido: Account UUID.

8. Listar Etiquetas (List Tags)

• Función: Devuelve todas las etiquetas creadas en la empresa.
• Aplicación práctica: El UUID de la etiqueta puede utilizarse para asociarlo a contactos específicos.
• Parámetro requerido: Account UUID.

9. Listar Apps (List Apps)

• Función: Lista todas las apps creadas dentro de la empresa, normalmente usadas para webhooks y tokens de integración.
• Parámetro requerido: Account UUID.

10. Listar Webhooks (List Webhooks)

• Función: Devuelve todos los webhooks vinculados a una app específica.
• Parámetro requerido: Application UUID.

Cómo Obtener Account UUID, Contact UUID y Application UUID

Account UUID y Application UUID

• El Account UUID es el identificador único de la empresa vinculada a tu usuario.
• El Application UUID es el identificador único de la app vinculada a tu empresa.
• Para obtenerlos, solo debes seguir este paso a paso/enlace (mismo proceso usado para generar el token).

Contact UUID

• El Contact UUID es el identificador único de un contacto específico.
• Puede obtenerse mediante el nodo List and Search Contacts.
• Al usar este nodo con el Account UUID, tendrás acceso a la lista de todos los contactos vinculados a la empresa. Dentro de la respuesta, cada contacto viene con su respectivo UUID.
• Este identificador es esencial para nodos que necesitan referirse directamente a un contacto, como List Messages from Contact ID.