Os nodes de listagem da Poli são responsáveis por buscar e organizar informações já cadastradas no sistema, como contas, canais, usuários, contatos, mensagens, equipes, templates, tags, apps e webhooks.
Esses nodes são muito úteis quando você precisa consultar dados antes de executar alguma ação, ou quando deseja automatizar fluxos que dependem de informações específicas (por exemplo: buscar um contato para depois enviar uma mensagem).

Neste tutorial, você vai entender:

1. Quais são os nodes de listagem disponíveis atualmente.
2. O que cada node faz.
3. Quais parâmetros ou identificadores são necessários para que o node funcione.
4. Como conseguir os identificadores mais utilizados: account_uuid e contact_uuid.

⚠ Atenção: Antes de utilizar qualquer node de listagem, é obrigatório ter em mãos um token de acesso. Esse token será usado em todas as requisições. Caso ainda não tenha, veja como gerar e salvar o seu neste link/tutorial.

Nodes de Listagem disponíveis no n8n

Atualmente existem 10 nodes de listagem. A seguir, explico detalhadamente a funcionalidade de cada um e os requisitos para utilizá-lo:

1. List Accounts

• Função: Retorna todas as empresas (accounts) vinculadas ao usuário do token.
• Parâmetro necessário: Apenas o token.

2. List Channels

• Função: Retorna todos os canais de comunicação vinculados a uma determinada empresa.
• Parâmetro necessário: Account UUID.

3. List and Search Users

• Função: Lista todos os usuários vinculados a uma empresa.
• Parâmetro necessário: Account UUID.

4. List Messages from Contact ID

• Função: Lista todas as mensagens vinculadas a um contato específico.
• Parâmetro necessário: Contact UUID.

5. List and Search Contacts

• Função: Retorna todos os contatos de uma empresa, junto com seus respectivos UUIDs.\'
• Parâmetro necessário: Account UUID.

6. List Teams

• Função: Retorna todos os times/departamentos vinculados a uma empresa.
• Parâmetro necessário: Account UUID.

7. List Templates

• Função: Retorna todos os templates criados na empresa.
• Aplicação prática: Esses templates são utilizados posteriormente para o envio de mensagens via WhatsApp ou outros canais.
• Parâmetro necessário: Account UUID.

8. List Tags

• Função: Retorna todas as tags criadas na empresa.
• Aplicação prática: O UUID da tag pode ser usado para associá-la a contatos específicos.
• Parâmetro necessário: Account UUID.

9. List Apps

• Função: Lista todos os aplicativos criados dentro da empresa, geralmente usados para webhooks e tokens de integração.
• Parâmetro necessário: Account UUID.

10. List Webhooks

• Função: Retorna todos os webhooks vinculados a um determinado aplicativo.
• Parâmetro necessário: Application UUID (UUID do app).

Como conseguir o Account UUID, Contact UUID e Application UUID

Account UUID e Application UUID

O Account UUID é o identificador único da empresa vinculada ao seu usuário.

O Application UUID é o identificador único do app vinculada a sua empresa.

• Para obtê-los, basta seguir este passo a passo/link (mesmo processo utilizado para gerar o token).

Contact UUID

O Contact UUID é o identificador único de um contato específico.

• Ele pode ser obtido através do node List and Search Contacts.
• Ao utilizar esse node com o Account UUID, você terá acesso à lista de todos os contatos vinculados à empresa. Dentro da resposta, cada contato vem com o seu respectivo UUID.
• Esse identificador é essencial para nodes que precisam se referir diretamente a um contato, como o List Messages from Contact ID.