Poli icon

Poli

Node principal para interagir com a API da Poli

Actions22

Overview

This node integrates with the Poli API to send messages by phone number. Specifically, the "Send Message By Phone" operation under the "Message" resource allows users to send a text message directly to a specified phone number via a configured account and channel.

Common scenarios where this node is beneficial include:

  • Sending SMS notifications or alerts to customers or users.
  • Automating customer engagement by sending personalized messages.
  • Integrating messaging capabilities into workflows for marketing, support, or transactional communications.

For example, you could use this node to send appointment reminders to clients by specifying their phone numbers, or to notify users about order status updates.

Properties

Name Meaning
Account ID The identifier of the Poli account from which the message will be sent.
Phone Number The recipient's phone number to which the message will be delivered.
Account Channel ID The specific channel UUID within the account used to send the message (e.g., SMS channel).
Text The content of the message to be sent. Defaults to "Teste de mensagem" if not changed.

Output

The node outputs JSON data representing the result of the message sending operation. This typically includes details such as message status, message ID, timestamps, and any relevant metadata returned by the Poli API confirming the message was sent or queued.

If the node supports binary data output (not indicated here), it would represent attachments or media sent along with the message, but in this case, the focus is on text message sending.

Dependencies

  • Requires an active Poli API connection authenticated via an API key credential.
  • The node depends on the Poli API service being available and reachable.
  • Proper configuration of the account and channel IDs within Poli is necessary to send messages successfully.

Troubleshooting

  • Common Issues:

    • Invalid or missing Account ID, Channel ID, or Phone Number can cause failures.
    • Network connectivity issues may prevent communication with the Poli API.
    • Insufficient permissions or incorrect API credentials will result in authentication errors.

  • Error Messages:

    • "Resource 'message' not found": Indicates the resource parameter is incorrect or missing.
    • "Operation 'sendByPhone' not found for resource 'message'": Means the operation name is invalid or unsupported.
    • API errors related to invalid phone numbers or channel configurations will be returned from the Poli API; verify inputs accordingly.

  • Resolutions:

    • Double-check all input parameters for correctness.
    • Ensure the API key credential is valid and has required permissions.
    • Verify that the account and channel IDs exist and are active in the Poli platform.
    • Test network connectivity and retry if transient errors occur.

Links and References

Discussion