Create and Join Call Sessions with Plivo and Ultravox AI Voice Assistant

This n8n workflow demonstrates how to initiate and manage call sessions, likely integrating a telephony provider like Plivo with an AI voice assistant service such as Ultravox. It acts as a foundational setup for building interactive voice applications.

What it does

This workflow is designed to handle incoming requests, process them, and respond, laying the groundwork for more complex voice interactions.

1. Listens for Incoming Requests: The workflow starts with a Webhook node, which acts as an entry point, listening for incoming HTTP requests. This is typically how external systems (like a telephony platform or a web application) would trigger the workflow.
2. Prepares Data (Edit Fields): An Edit Fields (Set) node is used to manipulate or add data to the incoming request's payload. This step is crucial for transforming the data into a format required by subsequent nodes, such as setting parameters for API calls.
3. Makes an API Call: An HTTP Request node is configured to send an HTTP request to an external service. In the context of the workflow's directory name, this would likely be used to interact with a telephony API (like Plivo) to create a call session or an AI voice assistant API (like Ultravox) to initiate a conversation.
4. Responds to the Webhook: Finally, a Respond to Webhook node sends a response back to the system that initially triggered the workflow. This could be an acknowledgment, status update, or instructions for the calling application.

Prerequisites/Requirements

To effectively use and extend this workflow, you will likely need:

• n8n Instance: A running instance of n8n.
• Plivo Account: An account with Plivo (or a similar CPaaS provider) for making and receiving calls, and obtaining necessary API credentials (Auth ID, Auth Token).
• Ultravox AI Voice Assistant Account: An account with Ultravox (or a similar AI voice assistant service) for integrating intelligent voice interactions.
• API Keys/Credentials: API keys or credentials for Plivo and Ultravox (or any other services you integrate via the HTTP Request node).
• Basic understanding of HTTP requests and JSON: To configure the HTTP Request and Edit Fields (Set) nodes.

Setup/Usage

1. Import the Workflow:
   • Copy the provided JSON code.
   • In your n8n instance, click "New Workflow".
   • Go to the "Workflows" menu, select "Import from JSON", and paste the copied JSON.
2. Configure the Webhook:
   • Open the Webhook node.
   • Note down the "Webhook URL". This is the endpoint you'll use to trigger the workflow from your external application or service.
3. Configure Edit Fields (Set):
   • Review the Edit Fields (Set) node. Modify the fields and values as needed to prepare the data for your API calls. For example, you might set from_number, to_number, or initial text_to_speak for the AI assistant.
4. Configure HTTP Request:
   • Open the HTTP Request node.
   • Method: Set the appropriate HTTP method (e.g., POST, GET) for the API you are calling.
   • URL: Enter the API endpoint URL for Plivo, Ultravox, or your chosen service.
   • Headers: Add any necessary headers, such as Authorization headers with your API keys.
   • Body: Configure the request body with the data prepared in the Edit Fields (Set) node, or other static data required by the API.
   • Credentials: If the API requires authentication, consider using n8n's credential management for secure storage.
5. Configure Respond to Webhook:
   • The Respond to Webhook node is typically set up to return the output of the previous HTTP Request node. Ensure the "Response Mode" and "Response Data" are configured to send back relevant information to the caller.
6. Activate the Workflow:
   • Once configured, activate the workflow by toggling the "Active" switch in the top right corner of the n8n editor.

Now, any request sent to the Webhook URL will trigger this workflow, initiating the data preparation, API call, and response sequence.