Poli

Node principal para interagir com a API da Poli

Actions22

App Actions
- Create App
- List Apps
Account Actions
- List Accounts
Channel Actions
- List Channels
- Get Channel
Message Actions
- Send Message By Contact ID
- Send Message By Phone
Template Actions
Contact Actions
Tag Actions
- List Tags
- Create Tags
User Actions
- List and Search Users
Team Actions
- List Teams
Webhook Actions
- List Webhooks
- Create Webhook

Overview

This node operation "Send Template Message By Contact ID" allows sending a pre-defined message template to a specific contact identified by their Contact ID. It is useful in scenarios where you want to automate personalized communication using templates, such as sending notifications, reminders, or marketing messages to known contacts without manually crafting each message.

Practical examples include:

Sending appointment reminders to customers.
Delivering order status updates using standardized message templates.
Broadcasting promotional offers with dynamic parameters filled in the template.

Properties

Name	Meaning
Contact ID	The unique identifier of the contact to whom the template message will be sent.
Account Channel ID	The unique identifier of the account channel through which the message will be sent.
Template ID	The unique identifier of the message template to use for sending.
Header Parameters	A collection of parameters to fill the header part of the template. Each parameter has:
	- Type: either "Text" or "Date/Time".
	- Value: the actual value to insert in the header.
Body Parameters	A collection of parameters to fill the body part of the template. Each parameter has:
	- Type: either "Text" or "Date/Time".
	- Value: the actual value to insert in the body.

Output

The node outputs JSON data representing the result of the send operation. This typically includes confirmation details such as message ID, status, timestamps, or any error information returned by the API. The exact structure depends on the underlying API response but generally confirms whether the template message was successfully sent to the specified contact.

No binary data output is involved in this operation.

Dependencies

Requires an API key credential for authenticating with the external messaging service.
The node depends on the external service's API that supports sending template messages by contact ID.
Proper configuration of the account channel and template IDs within the external system is necessary before use.

Troubleshooting

Common Issues:
- Invalid or missing Contact ID, Account Channel ID, or Template ID will cause the operation to fail.
- Incorrect parameter types or values in header/body parameters may lead to template rendering errors.
- Network or authentication failures can prevent message delivery.
Error Messages:
- "Resource 'template' not found" or "Operation 'sendByContactId' not found for resource 'template'" indicates misconfiguration or unsupported operation.
- API errors related to invalid IDs or unauthorized access usually require checking credentials and input values.
Resolution Tips:
- Verify all required IDs are correct and exist in the external system.
- Ensure the API key credential is valid and has sufficient permissions.
- Validate parameter types and values conform to expected formats (e.g., date/time strings).
- Check network connectivity and API endpoint availability.

Links and References

Refer to the external messaging service's API documentation for details on template message formatting and parameter usage.
Consult n8n documentation on how to configure API credentials and use fixed collections for parameters.