Poli icon

Poli

Node principal para interagir com a API da Poli

Overview

The "Update Contact" operation in this node allows users to modify existing contact information within the Poli platform via its API. This operation is useful when you need to update details such as a contact's name or profile picture after the contact has been created.

Practical scenarios include:

  • Correcting or updating a contact’s name.
  • Changing or adding a profile picture for a contact.
  • Adjusting contact attributes dynamically based on new information.

This operation helps maintain accurate and up-to-date contact records, which is essential for personalized communication and customer management workflows.

Properties

Name Meaning
Contact UUID The unique identifier (UUID) of the contact to update.
Attributes Collection of contact attributes to update:
- Name: The contact's name.
- Picture File ID: The ID of the file representing the contact's profile picture.
Options Additional options for the update response:
- Include: Specifies extra data to include in the response. Possible values are:
- Attributes
- Status
- Tags
- Channels
- Metadata

Output

The output JSON contains the updated contact data returned from the API. Depending on the selected "Include" options, the response may include:

  • Updated contact attributes (e.g., name, picture).
  • Contact status information.
  • Associated tags.
  • Linked communication channels.
  • Metadata related to the contact.

If binary data were involved (e.g., profile pictures), it would be handled accordingly, but this operation primarily deals with JSON data updates.

Dependencies

  • Requires an active connection to the Poli API using a valid API authentication token.
  • The node depends on the Poli API service being available and accessible.
  • Proper credentials must be configured in n8n to authenticate requests.

Troubleshooting

  • Common Issues:

    • Providing an invalid or non-existent Contact UUID will result in errors indicating the contact was not found.
    • Omitting required fields like Contact UUID will cause validation errors.
    • Network or authentication failures can prevent successful updates.
  • Error Messages:

    • "Resource 'contact' não encontrado": The specified resource is not recognized; ensure "contact" is selected.
    • "Operação 'update' não encontrada para o resource 'contact'": The update operation is not available for contacts; verify operation selection.
    • API errors related to invalid UUID or insufficient permissions should be checked by reviewing the input parameters and API credentials.
  • Resolution Tips:

    • Double-check the Contact UUID for correctness.
    • Ensure all required properties are provided.
    • Verify API credentials and network connectivity.
    • Review included options to confirm they are supported.

Links and References

Discussion