Telnyx AI icon

Telnyx AI

Interact with Telnyx AI API

Actions15

Overview

This node allows users to create an event for a specified assistant within the Telnyx AI platform. Specifically, it schedules communication events such as phone calls or SMS chats between an agent and an end user through a chosen conversation channel. This is useful for automating outreach, reminders, or interactive sessions managed by an AI assistant.

Common scenarios:

  • Scheduling a phone call event where an AI assistant initiates a call from an agent to an end user at a specific time.
  • Scheduling an SMS chat event where a text message is sent to an end user via the assistant.
  • Automating customer engagement workflows that require timed interactions.

Practical example:
You want to schedule an SMS reminder to a customer about an upcoming appointment. You select the assistant managing the interaction, set the conversation channel to SMS chat, specify the customer's phone number as the end user target, provide the agent's phone number, set the scheduled datetime, and write the reminder text. The node then creates this event in the Telnyx system.

Properties

Name Meaning
Assistant The assistant to get events for. Can be selected from a list of assistants or specified by ID.
Conversation Channel The type of conversation channel. Options: "Phone Call" or "SMS Chat".
End User Target The phone number or SIP URI to which the call or text will be scheduled (the recipient).
Agent Target The phone number or SIP URI from which the call or text will be scheduled (the sender/agent).
Scheduled At The ISO 8601 datetime when the event should be scheduled to occur.
Text Required only for SMS chat events. The text message content to send to the end user.
Conversation Metadata Optional JSON object containing additional metadata related to the conversation/event.

Output

The node outputs JSON data representing the created assistant event as returned by the Telnyx AI API. This typically includes details such as event ID, status, scheduled time, targets, and any other relevant metadata confirming the event creation.

If binary data were involved (e.g., audio recordings), it would be summarized here, but this node focuses on scheduling events and does not output binary data.

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

  • Missing required fields: Ensure all required properties are provided, especially the assistant selection, conversation channel, end user target, agent target, and scheduled datetime.
  • Invalid datetime format: The Scheduled At property must be in valid ISO 8601 format (e.g., 2025-06-17T14:20:39Z). Incorrect formats may cause errors.
  • Text missing for SMS chat: When using the SMS chat channel, the Text property is mandatory. Omitting it will result in an error.
  • Authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
  • API rate limits or network issues: These can cause request failures; check connectivity and Telnyx service status if problems persist.

Links and References

Discussion