Poli icon

Poli

Node principal para interagir com a API da Poli

Actions22

Overview

This node enables sending a pre-defined template message directly to a phone number using the Poli API. It is particularly useful for automating communication workflows where standardized messages need to be sent to users or customers via SMS or messaging apps that support templates. For example, businesses can use this node to send appointment reminders, order confirmations, or notifications by specifying a template and the recipient's phone number in E.164 format.

Properties

Name Meaning
Account ID The unique identifier of the Poli account from which the message will be sent.
Phone Number (E.164 format) The recipient's phone number in international E.164 format (e.g., +1234567890).
Account Channel ID The identifier of the specific channel within the account used to send the message (e.g., SMS, WhatsApp).
Template ID The identifier of the message template to be used for sending.
Header Parameters Optional parameters to fill in the header section of the template. Each parameter has a type (Text or Date/Time) and a value. Multiple header parameters can be added.
Body Parameters Optional parameters to fill in the body section of the template. Each parameter has a type (Text or Date/Time) and a value. Multiple body parameters can be added.

Output

The node outputs JSON data representing the result of the send operation. This typically includes confirmation details such as message status, message ID, timestamps, or any error information returned by the Poli API. The output does not include binary data.

Dependencies

  • Requires an active Poli API account with valid credentials configured in n8n.
  • Needs proper API authentication token or API key credential set up in n8n to authorize requests.
  • The phone number must be provided in E.164 format to ensure correct routing.
  • The specified template and channel IDs must exist and be accessible under the given account.

Troubleshooting

  • Common Issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect phone number format (not E.164) may lead to message delivery errors.
    • Using non-existent or unauthorized template or channel IDs will result in errors.
    • Missing required parameters like Account ID or Template ID will prevent execution.

  • Error Messages:

    • "Resource 'template' not found": Indicates the resource parameter is incorrect or unsupported.
    • "Operation 'sendByPhone' not found for the resource 'template'": Means the operation is invalid for the selected resource.
    • API errors related to authorization or invalid parameters will be passed through from the Poli API; check credentials and input values accordingly.

  • Resolution Tips:

    • Verify all IDs (account, channel, template) are correct and belong to your Poli account.
    • Ensure phone numbers follow the E.164 standard.
    • Confirm API credentials are correctly configured and have necessary permissions.
    • Use the node’s error output to inspect detailed API response messages.

Links and References

Discussion