Actions15
- Assistant Actions
- Assistant Event Actions
- Chat Actions
- Conversation Actions
- Voice Actions
Overview
The "Get Many" operation for the "Assistant Event" resource in this node retrieves multiple events related to a specified assistant from the Telnyx AI platform. This operation is useful for scenarios where you want to analyze or monitor the history of interactions, conversations, or activities associated with an assistant over time.
Practical examples include:
- Fetching all phone call or SMS chat events for a particular assistant within a specific date range.
- Paginating through large sets of assistant events to process or display them incrementally.
- Filtering events by conversation channel to focus on a particular mode of communication.
Properties
| Name | Meaning |
|---|---|
| Assistant | The assistant to get events for. Can be selected from a list of assistants or specified by ID. |
| Additional Fields | Optional filters and pagination controls: |
| - Conversation Channel | Filter events by type of conversation channel. Options: Phone Call, SMS Chat. |
| - From Date | Filter events starting from this date/time. |
| - To Date | Filter events up to this date/time. |
| - Page Number | Specify which page of results to retrieve (minimum 1). |
| - Page Size | Number of results per page (between 1 and 100). |
Output
The output contains a JSON array of assistant event objects matching the query parameters. Each event object typically includes details such as event type, timestamp, conversation channel, and other metadata relevant to the assistant's activity.
If binary data were involved (e.g., audio recordings), it would be included in a separate binary property, but this operation focuses on event metadata only.
Dependencies
- Requires an API key credential for authenticating with the Telnyx AI API.
- The node communicates with the Telnyx API endpoint at
https://api.telnyx.com. - Proper configuration of the API key credential in n8n is necessary for successful requests.
Troubleshooting
Common issues:
- Invalid or missing API key will result in authentication errors.
- Specifying an invalid assistant ID or selecting an assistant that does not exist may return empty results or errors.
- Using date filters in incorrect formats might cause request failures.
- Requesting pages beyond the available range will return empty results.
Error messages:
- Authentication errors: Check that the API key credential is correctly set and has required permissions.
- Validation errors on input fields: Ensure dates are valid ISO strings and page numbers/sizes are within allowed ranges.
- Network or API errors: Verify network connectivity and that the Telnyx API service is operational.