Poli icon

Poli

Node principal para interagir com a API da Poli

Overview

This node interacts with the Poli API to list messages associated with a specific contact identified by their UUID. It is useful in scenarios where you want to retrieve communication history or message logs for a particular contact within your system. For example, customer support teams can use this node to fetch all messages exchanged with a customer to review past interactions or analyze conversation context.

Properties

Name Meaning
Contact UUID The unique identifier (UUID) of the contact whose messages you want to list.
Options Additional parameters to customize the listing:
- Include Extra fields to include in the response; currently supports including "Components".
- Order Field and direction to sort the results, e.g., created_at desc to order by creation date descending.
- Page The page number of results to retrieve (minimum 1).
- Per Page Number of items per page (between 1 and 100).

Output

The node outputs a JSON array containing the messages related to the specified contact UUID. Each item in the array represents a message object with its details as returned by the Poli API. If the "Include" option is used with "Components," additional nested data about message components will be included in each message object.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the Poli API via an API key credential configured in n8n.
  • The node depends on the Poli API's availability and correct permissions to access contact messages.
  • No other external dependencies are required.

Troubleshooting

  • Common Issues:

    • Invalid or missing Contact UUID: Ensure the UUID provided is correct and corresponds to an existing contact.
    • API authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
    • Pagination issues: If requesting pages beyond available data, the result may be empty.
  • Error Messages:

    • "Resource 'contact' não encontrado": The resource parameter is incorrect or not supported.
    • "Operação 'listMessages' não encontrada para o resource 'contact'": The operation is invalid for the selected resource.
    • Network or API errors: Check network connectivity and API status.

Resolving these typically involves verifying input parameters, credentials, and API service status.

Links and References

Discussion