TransferCall function setup with API

V

Vapi•11/4/24, 7:20 AM

Relevant threads

These are relevant threads you might take a look into before continuing further:

@1298708722218041446

V

Vapi•11/4/24, 7:20 AM

@Radim Kopp
Hello! I'm glad to assist you with the transferCall function. To ensure that assistants within the same organization can transfer calls to each other or to a specific phone number, you need to follow these steps:

Make sure that the assistant you're trying to transfer the call to exists and is properly configured within your organization.
Verify that you are using the correct assistant name or ID. The assistant name should be the one that was specified when the assistant was created.
Ensure that the forwardingPhoneNumber is correctly set up on the assistant you want to transfer the call to.

If you've checked these points and the issue persists, it could be a problem with the configuration on the backend or a temporary service issue. In that case, it would be best to reach out to the support team for further assistance.

If you provide me with the assistant's name or ID and the forwardingPhoneNumber, I can help you initiate the transferCall function. If you have any other questions or need further clarification, feel free to ask!

V

Vapi•11/4/24, 7:20 AM

You can continue this conversation by mentioning me in the message.

D

dry-scarletOP•11/4/24, 7:27 AM

@Vapi
firstId: b974d85a-4009-41a2-bdb2-1cc119bc28c6
secondId: d054d8cc-21b8-4cc4-af1e-a7eeb256db43
phoneNumber: +420xxxxxxxxx

V

Vapi•11/4/24, 7:27 AM

@Radim Kopp
Thank you for providing the assistant IDs and the phone number. To set up the transferCall function correctly, you'll need to use the assistant ID to refer to the assistant you want to transfer the call to. Here's how you can set it up:

When configuring the transferCall function, use the
```
assistantId
```
```
assistantId
```
field to specify the ID of the assistant you want to transfer the call to. For example, if you want to transfer a call from the first assistant to the second one, you would use
```
secondId
```
secondId
```
secondId
```
secondId
as the
```
assistantId
```
```
assistantId
```
.
If you want to transfer the call to a phone number instead of an assistant, you would use the
```
phoneNumber
```
phoneNumber
```
phoneNumber
```
phoneNumber
field to specify the destination phone number.

Here's a sample configuration for transferring a call to another assistant:

{
  "transferCall": {
    "destinations": [
      {
        "assistant": {
          "assistantId": "d054d8cc-21b8-4cc4-af1e-a7eeb256db43"
        }
      }
    ]
  }
}

{
  "transferCall": {
    "destinations": [
      {
        "assistant": {
          "assistantId": "d054d8cc-21b8-4cc4-af1e-a7eeb256db43"
        }
      }
    ]
  }
}

{
  "transferCall": {
    "destinations": [
      {
        "assistant": {
          "assistantId": "d054d8cc-21b8-4cc4-af1e-a7eeb256db43"
        }
      }
    ]
  }
}

{
  "transferCall": {
    "destinations": [
      {
        "assistant": {
          "assistantId": "d054d8cc-21b8-4cc4-af1e-a7eeb256db43"
        }
      }
    ]
  }
}

And here's a sample configuration for transferring a call to a phone number:

{
  "transferCall": {
    "destinations": [
      {
        "phoneNumber": "+420xxxxxxxxx"
      }
    ]
  }
}

{
  "transferCall": {
    "destinations": [
      {
        "phoneNumber": "+420xxxxxxxxx"
      }
    ]
  }
}

{
  "transferCall": {
    "destinations": [
      {
        "phoneNumber": "+420xxxxxxxxx"
      }
    ]
  }
}

{
  "transferCall": {
    "destinations": [
      {
        "phoneNumber": "+420xxxxxxxxx"
      }
    ]
  }
}

Please replace

+420xxxxxxxxx

+420xxxxxxxxx

+420xxxxxxxxx

+420xxxxxxxxx with the actual phone number you wish to transfer the call to.

If you have already tried this and it's not working, please ensure that both assistants are active and properly configured in your organization. If the problem persists, it may be best to contact support for a more in-depth investigation.

D

dry-scarletOP•11/4/24, 7:28 AM

Can you merge it? I need these 3 to be in one function @Vapi

V

Vapi•11/4/24, 7:29 AM

@Radim Kopp
Certainly! To merge the transfer to both assistants and the phone number into one function, you would configure the

transferCall

transferCall

function with multiple destinations. Here's how you can set it up:

{
  "transferCall": {
    "destinations": [
      {
        "assistant": {
          "assistantId": "b974d85a-4009-41a2-bdb2-1cc119bc28c6"
        }
      },
      {
        "assistant": {
          "assistantId": "d054d8cc-21b8-4cc4-af1e-a7eeb256db43"
        }
      },
      {
        "phoneNumber": "+420xxxxxxxxx"
      }
    ]
  }
}

{
  "transferCall": {
    "destinations": [
      {
        "assistant": {
          "assistantId": "b974d85a-4009-41a2-bdb2-1cc119bc28c6"
        }
      },
      {
        "assistant": {
          "assistantId": "d054d8cc-21b8-4cc4-af1e-a7eeb256db43"
        }
      },
      {
        "phoneNumber": "+420xxxxxxxxx"
      }
    ]
  }
}

{
  "transferCall": {
    "destinations": [
      {
        "assistant": {
          "assistantId": "b974d85a-4009-41a2-bdb2-1cc119bc28c6"
        }
      },
      {
        "assistant": {
          "assistantId": "d054d8cc-21b8-4cc4-af1e-a7eeb256db43"
        }
      },
      {
        "phoneNumber": "+420xxxxxxxxx"
      }
    ]
  }
}

{
  "transferCall": {
    "destinations": [
      {
        "assistant": {
          "assistantId": "b974d85a-4009-41a2-bdb2-1cc119bc28c6"
        }
      },
      {
        "assistant": {
          "assistantId": "d054d8cc-21b8-4cc4-af1e-a7eeb256db43"
        }
      },
      {
        "phoneNumber": "+420xxxxxxxxx"
      }
    ]
  }
}

This configuration will allow the call to be transferred to either of the two assistants or the specified phone number. Please ensure that the assistant IDs and phone number are correct and that all destinations are properly set up to receive transfers within your organization.

If you need any further assistance or if you encounter any issues, please let me know!

D

dry-scarletOP•11/4/24, 8:14 AM

There is only assistantName in the API refference playround @Vapi

V

Vapi•11/4/24, 8:14 AM

@Radim Kopp
I apologize for the confusion. If the API reference specifies

assistantName

assistantName

as the field to use, then you should indeed use the name of the assistant rather than the ID. However, you mentioned that using the assistant name did not work for you.

In this case, it's important to ensure that the name you are using is exactly as it was defined when the assistant was created. Remember, the name is for internal labeling use and is case-sensitive.

Here's how you would structure the

transferCall

transferCall

function using

assistantName

assistantName

:

{
  "transferCall": {
    "destinations": [
      {
        "assistant": {
          "assistantName": "First Assistant Name"
        }
      },
      {
        "assistant": {
          "assistantName": "Second Assistant Name"
        }
      },
      {
        "phoneNumber": "+420xxxxxxxxx"
      }
    ]
  }
}

{
  "transferCall": {
    "destinations": [
      {
        "assistant": {
          "assistantName": "First Assistant Name"
        }
      },
      {
        "assistant": {
          "assistantName": "Second Assistant Name"
        }
      },
      {
        "phoneNumber": "+420xxxxxxxxx"
      }
    ]
  }
}

{
  "transferCall": {
    "destinations": [
      {
        "assistant": {
          "assistantName": "First Assistant Name"
        }
      },
      {
        "assistant": {
          "assistantName": "Second Assistant Name"
        }
      },
      {
        "phoneNumber": "+420xxxxxxxxx"
      }
    ]
  }
}

{
  "transferCall": {
    "destinations": [
      {
        "assistant": {
          "assistantName": "First Assistant Name"
        }
      },
      {
        "assistant": {
          "assistantName": "Second Assistant Name"
        }
      },
      {
        "phoneNumber": "+420xxxxxxxxx"
      }
    ]
  }
}

Please replace

"First Assistant Name"

"First Assistant Name"

"First Assistant Name"

"First Assistant Name" and

"Second Assistant Name"

"Second Assistant Name"

"Second Assistant Name"

"Second Assistant Name" with the actual names of the assistants you wish to transfer the call to. The

phoneNumber

phoneNumber

phoneNumber

phoneNumber should be the actual number you want to transfer the call to.

If you're still experiencing issues, it might be necessary to check with support to ensure that the assistant names are correct and that there are no issues with the transferCall setup in your organization's configuration.

D

dry-scarletOP•11/4/24, 8:58 AM

I tried this, but this doesnt work. It's fallsback to the fallBackDestination. I edited the phone number, I dont want it here. But this JSON doesnt work. @Vapi

{
"id": "2c4a658a-89c9-40a4-a74e-e9ee78b3e31f",
"createdAt": "2024-11-04T08:53:28.049Z",
"updatedAt": "2024-11-04T08:53:28.049Z",
"type": "transferCall",
"function": {
"name": "transferCall",
"description": "Slouží pro přepojování hovoru."
},
"orgId": "5866d026-db4b-40ed-abaf-854bc6c14d1c",
"destinations": [
{
"type": "assistant",
"message": "Přepojuji vás na jiného asistenta. Chvíli strpení prosím.",
"description": "Tento asistent slouží pro připomenutí rezervace a následného potvrzení do systému, že klient přijde.",
"assistantName": "Eva"
},
{
"type": "assistant",
"message": "Přepojuji vás na jiného asistenta. Chvíli strpení prosím.",
"description": "Tento asistent slouží pro vytváření, měnění, mazaní, vyhledání rezervace nebo pro zjištění časové dostupnosti",
"assistantName": "Linda"
},
{
"type": "number",
"number": "+420721xxxxxx",
"message": "Přepojuji vás do kliniky. Chvíli strpení prosím.",
"description": "Přepojení přímo do kliniky"
}
]
}

V

Vapi•11/4/24, 8:58 AM

@Radim Kopp
I'm sorry to hear that the transfer isn't working as expected. If the call is falling back to the

fallBackDestination

fallBackDestination

fallBackDestination

fallBackDestination, it suggests that there might be an issue with the destination details or the assistants may not be correctly configured to receive transfers.

Here are a few steps you can take to troubleshoot the issue:

Check Assistant Names: Ensure that the assistant names "Eva" and "Linda" are spelled correctly and match exactly with the names configured in your organization, including case sensitivity.
Assistant Availability: Verify that the assistants "Eva" and "Linda" are currently active and available to take calls.
Organization Configuration: Confirm that your organization ID
```
5866d026-db4b-40ed-abaf-854bc6c14d1c
```
5866d026-db4b-40ed-abaf-854bc6c14d1c
```
5866d026-db4b-40ed-abaf-854bc6c14d1c
```
5866d026-db4b-40ed-abaf-854bc6c14d1c
is correct and that the assistants are associated with this organization.
Permissions and Settings: Make sure that there are no restrictions or settings preventing the assistants from receiving transferred calls.
API Version: Check if there have been any updates to the API that might affect how the transferCall function works.
Support Team: If you've verified all the above and the issue persists, it may be necessary to contact the support team for a more detailed investigation. They can check the backend logs and configurations to identify the root cause of the problem.

Since you've edited the phone number for privacy, please ensure that the actual number used in the configuration is valid and capable of receiving calls.

If you need further assistance, please let me know, and I'll do my best to help you resolve this issue.

D

dry-scarletOP•11/4/24, 8:59 AM

I used Get assistans and coppied the names. They are available, Org number must be correct, I used playround with private api key. Trasfercall to only number worked before. It should all be correct
@Vapi

V

Vapi•11/4/24, 9:00 AM

@Radim Kopp
Given that you've verified the assistant names, availability, organization ID, and that transferring to a number has worked previously, it seems like your setup should indeed be correct. Since the issue persists, it's possible that there might be a more subtle configuration issue or a limitation within the system that isn't immediately apparent.

At this point, the best course of action would be to reach out to the support team with the details you've provided here. They will have the necessary tools and access to logs to diagnose the issue more effectively. They can also confirm if there are any recent changes to the API or known issues that might be affecting the transferCall function.

Please provide them with the JSON configuration you've used, the steps you've taken to troubleshoot, and any other relevant details. The support team should be able to guide you through resolving this issue.

If you need any further assistance or have additional questions, feel free to ask.

D

dry-scarletOP•11/4/24, 9:00 AM

@Vapi Team Can you please look at this? I would appreciate it.

Ddry-scarlet Hello, I have a question about transferCall funtion. I tried to set it up so t...

D

dangerous-fuchsia•11/4/24, 11:17 AM

Hey @Radim Kopp can you share the tool call CURL?

Ddangerous-fuchsia Hey @Radim Kopp can you share the tool call CURL?

D

dry-scarletOP•11/4/24, 11:39 AM

curl -X POST https://api.vapi.ai/tool \
-H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json" \
-d '{
"type": "transferCall",
"destinations": [
{
"type": "assistant",
"assistantName": "Eva",
"description": "Tento asistent slouží pro připomenutí rezervace a následného potvrzení do systému, že klient přijde.",
"message": "Přepojuji vás na jiného asistenta. Chvíli strpení prosím."
},
{
"type": "assistant",
"assistantName": "Linda",
"message": "Přepojuji vás na jiného asistenta. Chvíli strpení prosím.",
"description": "Tento asistent slouží pro vytváření, měnění, mazaní, vyhledání rezervace nebo pro zjištění časové dostupnosti"
},
{
"type": "number",
"number": "+420XXXXXXXXX",
"description": "Přepojení přímo do kliniky",
"message": "Přepojuji vás do kliniky. Chvíli strpení prosím."
}
],
"function": {
"name": "transferCall",
"description": "Slouží pro přepojování hovoru."
}
}'

D

dry-scarletOP•11/4/24, 11:39 AM

You mean this? I just removed the Bearer

Ddry-scarlet curl -X POST https://api.vapi.ai/tool \ -H "Authorization: Bearer TOKEN" \ ...

D

dangerous-fuchsia•11/4/24, 1:20 PM

Your tool call format is correct, but you might be using wrong assistant name double check your assistant name in dashboard.

Ddangerous-fuchsia Your tool call format is correct, but you might be using wrong assistant name do...

D

dry-scarletOP•11/4/24, 1:21 PM

I coppied the exact name that Get assistants gave me

D

dry-scarletOP•11/4/24, 1:21 PM

It didnt work yesterday, yesterday I took the name from dashboard, but apperently the names are same

D

dry-scarletOP•11/4/24, 1:21 PM

So, it's weird

D

dangerous-fuchsia•11/4/24, 1:26 PM

@Radim Kopp you can use it for assistants in your org only.

Ddangerous-fuchsia @Radim Kopp you can use it for assistants in your org only.

D

dry-scarletOP•11/4/24, 1:39 PM

I know I'm doing that

D

dry-scarletOP•11/4/24, 1:40 PM

These two are in the same dashboard and Org.

Ddry-scarlet These two are in the same dashboard and Org.

D

dangerous-fuchsia•11/4/24, 1:44 PM

Man you must be doing something wrong can you share complete CURL and OrgID.

Ddangerous-fuchsia Man you must be doing something wrong can you share complete CURL and OrgID.

D

dry-scarletOP•11/4/24, 1:46 PM

wydm complete? This wasnt complete? I deleted the private key from this, otherwise it all I coppied from the playground

Ddry-scarlet I tried this, but this doesnt work. It's fallsback to the fallBackDestination. I...

D

dry-scarletOP•11/4/24, 1:49 PM

I sent this earlier

D

dry-scarletOP•11/4/24, 1:49 PM

and then the thing that gets sent to create that

D

dry-scarletOP•11/5/24, 12:43 PM

@Vapi Team

D

dangerous-fuchsia•11/5/24, 3:24 PM

@Radim Kopp add following to the destination of type number and it will work.

"numberE164CheckEnabled": false

"numberE164CheckEnabled": false

"numberE164CheckEnabled": false

"numberE164CheckEnabled": false

Ddangerous-fuchsia @Radim Kopp add following to the destination of type number and it will work. `...

D

dry-scarletOP•11/5/24, 3:33 PM

Sadly it doesn't. It's still falling back to my second phone

D

dry-scarletOP•11/5/24, 3:34 PM

curl -X POST https://api.vapi.ai/tool \
-H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json" \
-d '{
"type": "transferCall",
"destinations": [
{
"type": "assistant",
"assistantName": "Eva",
"description": "Tento asistent slouží pro připomenutí rezervace a následného potvrzení do systému, že klient přijde.",
"message": "Přepojuji vás na jiného asistenta. Chvíli strpení prosím."
},
{
"type": "assistant",
"assistantName": "Linda",
"message": "Přepojuji vás na jiného asistenta. Chvíli strpení prosím.",
"description": "Tento asistent slouží pro vytváření, měnění, mazaní, vyhledání rezervace nebo pro zjištění časové dostupnosti"
},
{
"type": "number",
"number": "+420xxxxxxxxx",
"description": "Přepojení přímo do kliniky",
"message": "Přepojuji vás do kliniky. Chvíli strpení prosím.",
"numberE164CheckEnabled": false
}
],
"function": {
"name": "transferCall",
"description": "Slouží pro přepojování hovoru."
}
}'

D

dry-scarletOP•11/5/24, 3:34 PM

Result from API playground:

{
"id": "2c4a658a-89c9-40a4-a74e-e9ee78b3e31f",
"createdAt": "2024-11-04T08:53:28.049Z",
"updatedAt": "2024-11-04T08:53:28.049Z",
"type": "transferCall",
"function": {
"name": "transferCall",
"description": "Slouží pro přepojování hovoru."
},
"orgId": "5866d026-db4b-40ed-abaf-854bc6c14d1c",
"destinations": [
{
"type": "assistant",
"message": "Přepojuji vás na jiného asistenta. Chvíli strpení prosím.",
"description": "Tento asistent slouží pro připomenutí rezervace a následného potvrzení do systému, že klient přijde.",
"assistantName": "Eva"
},
{
"type": "assistant",
"message": "Přepojuji vás na jiného asistenta. Chvíli strpení prosím.",
"description": "Tento asistent slouží pro vytváření, měnění, mazaní, vyhledání rezervace nebo pro zjištění časové dostupnosti",
"assistantName": "Linda"
},
{
"type": "number",
"number": "+420721728086",
"message": "Přepojuji vás do kliniky. Chvíli strpení prosím.",
"description": "Přepojení přímo do kliniky"
}
]
}

D

dangerous-fuchsia•11/5/24, 3:35 PM

@Radim Kopp for new destination number delete your current tool and create it again.

D

dry-scarletOP•11/5/24, 3:35 PM

Names should be correct:
"orgId": "5866d026-db4b-40ed-abaf-854bc6c14d1c",
"name": "Eva",
"orgId": "5866d026-db4b-40ed-abaf-854bc6c14d1c",
"name": "Linda",

Ddangerous-fuchsia @Radim Kopp for new destination number delete your current tool and create it ag...

D

dry-scarletOP•11/5/24, 3:36 PM

I created a new one, it's easier then patch

Ddry-scarlet I created a new one, it's easier then patch

D

dangerous-fuchsia•11/5/24, 3:36 PM

Patch for destinations doesn't work.

D

dry-scarletOP•11/5/24, 3:36 PM

Okey, I didnt do that

D

dry-scarletOP•11/5/24, 3:36 PM

Ddangerous-fuchsia Patch for destinations doesn't work.

D

dry-scarletOP•11/5/24, 3:38 PM

It's just weird, everything worked in Vapi so far easily, I have no idea where am I making the misstake

D

dry-scarletOP•11/5/24, 3:39 PM

Can't pronounce 2025 in Czech and do this transfer

D

dry-scarletOP•11/5/24, 3:44 PM

The AI before said that I can do assistantId, but I dont see that in the options when creating

D

dangerous-fuchsia•11/5/24, 9:34 PM

Hey @Radim Kopp I believe it's an new issue "Can't pronounce 2025 in Czech and do this transfer" can you please create another ticket. If this is related to current ticket then eloborate more around your usage and expectations along with the call id.

Ddangerous-fuchsia Hey @Radim Kopp I believe it's an new issue "Can't pronounce 2025 in Czech and d...

D

dry-scarletOP•11/5/24, 9:35 PM

Will do

Ddry-scarlet Will do🫡

D

dangerous-fuchsia•11/5/24, 9:57 PM

ThankYou.

D

dry-scarletOP•11/5/24, 9:59 PM

@Shubham Bajaj This issue hasn't been solved, but the ticket is marked as solved, could you undo it please?

Ddry-scarlet @Shubham Bajaj This issue hasn't been solved, but the ticket is marked as solved...