Actions23
- Call Control Actions
- Answer Call
- Convert To On Spot Conference
- Delete On Spot Conference Participant
- Disable Api Notifications
- Enable Api Notifications
- Get On Spot Conference List
- Get On Spot Conference Participant List
- Get Sip Calls List
- Hold Call
- Join Calls
- Join On Spot Conference
- Join To Active Call
- Originate Advanced Call
- Play Prompt
- Progress Call
- Ring Call
- Start DTMF Detect
- Stop DTMF Detect
- Stop Play Prompt
- Terminate Call
- Transfer Call
- Unhold Call
- Update On Spot Conference Participant
Overview
The PortaOneCallControl node for n8n allows you to interact with the PortaOne Call Control API, specifically to perform the "Progress Call" operation. This operation is typically used in telephony workflows to advance or manipulate the state of a call (for example, to move a call from ringing to connected). Common scenarios include automated call handling, call routing, and integration with CRM or support systems where programmatic control over calls is required.
Practical Example:
You might use this node in a workflow that automatically progresses an inbound customer support call after verifying caller information, or as part of a system that manages outbound call campaigns.
Properties
| Name | Meaning |
|---|---|
| Authentication | The authentication method to use. Options: Token Authentication, Basic Authentication. |
| Call → Id | The unique identifier of the call to be progressed. |
| Call → Tag | An optional tag associated with the call, possibly for tracking or categorization. |
Output
- The output will be a JSON object containing the result of the "Progress Call" operation as returned by the PortaOne Call Control API.
- The exact structure depends on the API response, but it typically includes status, call identifiers, and any relevant metadata about the call's new state.
- If binary data is involved (not typical for this operation), it would represent call recordings or similar artifacts.
Dependencies
- External Services: Requires access to the PortaOne Call Control API.
- API Credentials: You must provide either a Token or Basic Authentication credentials:
- For Token Authentication:
portaOneCallControlTokenApi - For Basic Authentication:
portaOneCallControlBasicApi
- For Token Authentication:
- n8n Configuration: Ensure the appropriate credentials are set up in n8n’s credential store.
Troubleshooting
- Authentication Errors:
- Error Message: "Invalid credentials" or "Unauthorized"
Resolution: Check that the correct authentication method is selected and valid credentials are provided.
- Error Message: "Invalid credentials" or "Unauthorized"
- Missing Required Fields:
- Error Message: "Missing call id" or similar
Resolution: Ensure the "Id" field under "Call" is populated with a valid call identifier.
- Error Message: "Missing call id" or similar
- API Connectivity Issues:
- Error Message: "Network error" or "Cannot reach API"
Resolution: Verify network connectivity and that the PortaOne API endpoint is accessible from your n8n instance.
- Error Message: "Network error" or "Cannot reach API"