> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Triggering a VoiceAgent Call from Freshservice

> Automate outbound VoiceAgent calls directly from Freshservice

> [!NOTE]
>
> In this guide, you will learn how to automatically trigger a CloudTalk VoiceAgent call from Freshservice using the Workflow Automator.

**User level**: Admin

***

> [!WARNING]
>
> **Note:** Use the **Web Request Node**, not the Trigger Webhook node. The Web Request Node waits for the API response and supports JSON response parsing, so you can catch errors. The Trigger Webhook node is fire-and-forget and does not confirm success.

## Before you start

You will need:

* A CloudTalk VoiceAgent already created (note the VoiceAgent ID)

* CloudTalk API credentials (API Key and Secret) found in **Company Settings > Integrations > API** ([How to access and generate your CloudTalk API keys](https://help.cloudtalk.io/en/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys.md))

* A Freshservice **Pro plan** or above

* A phone number available on Requester records

## Locate your CloudTalk credentials

The Web Request Node has a built-in Basic Auth form, so no pre-encoding is needed.

1. In CloudTalk, go to **Company Settings > Integrations > API**

2. Note your **API Key ID** -- this will be the Username

3. Note your **API Secret** -- this will be the Password

## Set up the integration

### Create the Workflow

1\. In Freshservice, go to **Admin > Workflow Automator**

2\. Click **Create > Workflow**

3\. Set the **Event trigger**, for example:

* *Ticket raised*

* *Ticket updated* (status changes to Pending)

* *Requester replies*

![](https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15502021/cfe5ebee1bfc-image.png?fit=max\&auto=format\&n=akDGinDOBsihWn_p\&q=85\&s=256f95008b25fbab2b0b2bbe4c572d8c)

4\. Add **conditions** to filter which tickets trigger the call (e.g. requester phone is present, specific category)

### Add the Web Request Node

1\. Click **`+`** to add an action block

2\. Select **Web Request Node**

3\. Configure the node:

| **Field** | **Value** |
| - | - |
| Request type | POST |
| Endpoint | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Credentials | Inline Credential |
| Authentication | Basic Auth |
| Username | Your CloudTalk API Key ID |
| Password | Your CloudTalk API Secret |
| Headers | `Content-Type`: `application/json` |

4\. Under **Request body**, paste the following:

```json theme={"system"}
{  "call_number": "#{{ticket.requester.phone}}",  "voice_agent_id": "YOUR_VOICE_AGENT_ID"}
```

> [!WARNING]
>
> `call_number` and `voice_agent_id` are the only mandatory fields. You can also pass optional `call_properties` such as system prompt variables and output variables, depending on your VoiceAgent configuration. [Learn what to include](https://help.cloudtalk.io/en/articles/11401649-voiceagents-for-outbound-calls.md)

![](https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15502021/bd0f895867f5-image.png?fit=max\&auto=format\&n=akDGinDOBsihWn_p\&q=85\&s=ab3441168ef857eb20660f388de7dc13)

![](https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15502021/f00064942f5b-image.png?fit=max\&auto=format\&n=akDGinDOBsihWn_p\&q=85\&s=6d8c792ec9cf6d9a0fa081cb3da4045a)

5\. Connect the node to the trigger and click **Activate**

### Test and verify

1. Create or update a ticket that meets your trigger conditions

2. Open **Workflow Automator** and check the run history

3. Verify in CloudTalk that the VoiceAgent call was initiated

**You're all set!** 🚀 Your Freshservice workflow will now trigger a CloudTalk VoiceAgent call whenever a ticket meets your chosen conditions.

> [!NOTE]
>
> 💡 **API Limits to Keep in Mind**
>
> *To avoid failures or throttling, make sure your workflow handles call distribution carefully. Use delays or scheduling logic where needed, as the standard API rate limit (60 requests per minute) applies to the VoiceAgent endpoint.*

## Troubleshooting

| **Error** | **What to check** |
| - | - |
| **401 Unauthorized** | Regenerate and re-enter your API credentials in the Basic Auth fields |
| **400 Bad Request** | Ensure the phone number is in E.164 format (`+1234567890`) and that `voice_agent_id` is correct |
| **Workflow not triggering** | Check that the event conditions match your test ticket and that the workflow is activated |

***

Need help or have a question? Reach out through our [Support portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884). We're here for you.


## Related topics

- [Triggering a VoiceAgent Call from Freshdesk](https://help.cloudtalk.io/en/articles/15457387-triggering-a-voiceagent-call-from-freshdesk.md)
- [Triggering a VoiceAgent Call from Zendesk](https://help.cloudtalk.io/en/articles/15934846-triggering-a-voiceagent-call-from-zendesk.md)
- [Triggering a VoiceAgent Call from Pipedrive](https://help.cloudtalk.io/en/articles/15516233-triggering-a-voiceagent-call-from-pipedrive.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.