Actions22
- Broadcasts Actions
- Embeddings Actions
- Contacts Actions
- Conversations Actions
- Tags Actions
Overview
The "Create Broadcast" operation in the Broadcasts resource allows users to send a broadcast message through the Cogfy Messenger API. This node is useful for sending mass messages to multiple contacts filtered by specific criteria, such as tags or other attributes defined in a query. Typical use cases include marketing campaigns, announcements, or notifications sent to a targeted audience.
For example, a user can create a text broadcast titled "Holiday Sale" with promotional content and send it to all contacts tagged as "VIP customers" using a specified phone number ID.
Properties
| Name | Meaning |
|---|---|
| Type | The type of the broadcast message. Currently supports only "Text". |
| Title | The title of the broadcast message. |
| Content | The main content/body of the broadcast message. |
| Phone Number Id | The identifier of the phone number from which the broadcast will be sent. |
| Contacts Query | A JSON object defining the filter criteria to select contacts who will receive the broadcast. Typically includes tags or other contact attributes. |
Output
The node outputs JSON data representing the response from the Cogfy Messenger API after creating the broadcast. This typically includes details about the created broadcast such as its ID, status, and any metadata returned by the API.
There is no indication that the node outputs binary data.
Dependencies
- Requires an active connection to the Cogfy Messenger API.
- Needs an API authentication token or key configured in the node credentials.
- The base URL for the API must be set in the node's credential configuration.
Troubleshooting
- Invalid Contacts Query: If the JSON in the Contacts Query property is malformed or does not match expected schema, the API may reject the request. Ensure the JSON is valid and correctly structured.
- Missing Required Fields: All required properties (Type, Title, Content, Phone Number Id, Contacts Query) must be provided; otherwise, the node will fail.
- API Authentication Errors: If the API key or token is invalid or missing, the request will be unauthorized. Verify credentials are correctly set.
- Phone Number Id Not Found: Using an incorrect or non-existent phone number ID will cause the API to return an error. Confirm the phone number ID is valid and accessible.
- Network Issues: Connectivity problems between n8n and the Cogfy Messenger API can cause timeouts or failures.
Links and References
- Cogfy Messenger API Documentation (example placeholder link)
- n8n Documentation on Creating Custom Nodes