How do I connect CloudTalk?
Updated November 16, 2026
Connect CloudTalk once for the whole workspace. Your CloudTalk calls then sync into Breakcold, members can call a contact from Breakcold through CloudTalk Phone, and the matching record opens when a call rings.
Before you start
- You need to be an owner, admin or manager in Breakcold to connect it.
- You need a CloudTalk API key, which only a CloudTalk admin can create. In the CloudTalk Dashboard, open Account, then Settings, then API Keys, and create a key. Keep its ID and secret at hand.
- Breakcold connects to one phone provider at a time. Disconnect any other provider first.
Connect CloudTalk
- Open Settings → Calling. The Connections section lists the phone providers.
- Point at the CloudTalk card and click Connect with API key.
- Enter the API key ID and the API key secret.
- Under How far back to import, choose the last 7, 30 or 90 days, or the last 12 months.
- Click Connect CloudTalk.
Breakcold checks the key, then imports your past calls in the background. They appear on the Calling page as they arrive. To import an earlier period later, use the CloudTalk call history card on the same page.
How new calls reach Breakcold
What you see under the CloudTalk card depends on your CloudTalk plan.
On CloudTalk Essential or higher
Breakcold registers a signed webhook in CloudTalk for you. You'll find it in CloudTalk under Settings, then Webhooks, with the description Breakcold calling. The CloudTalk webhook card in Breakcold reads Signed webhook active, and each call appears in Breakcold as soon as it ends. There is nothing else to set up.
On a plan without webhooks
The CloudTalk Workflow setup card shows the values for a CloudTalk Workflow Automation, each with a Copy button. In CloudTalk:
- Create a Workflow Automation that starts on Call → Ended.
- Add an API request action with these values from Breakcold:
- HTTP method:
POST - Request URL: the address shown in Breakcold
- Content-Type header:
application/json - Authorization header: a header named
Authorizationwith the value Breakcold shows afterAuthorization:(it starts withBearer) - Request body:
{"event":"call_ended"}
- HTTP method:
- Save and turn on the workflow.
After the next call ends, the badge on the card changes from Waiting for the first Workflow notification to Workflow notifications received.
Map members to their CloudTalk agents
Click-to-call needs to know which CloudTalk agent each member is. In the Agent mapping card, choose the CloudTalk agent next to each workspace member. Can place calls turns on when you pick an agent; turn it off to keep a member's calls synced without letting them call from Breakcold.
A member left on Not mapped can't call from Breakcold: clicking a phone number asks them to map their CloudTalk agent first.
Call from Breakcold
CloudTalk Phone opens inside Breakcold, in a panel at the corner of the app. Sign in to CloudTalk there and set yourself online.
When you click a phone number in Breakcold, CloudTalk rings your agent first: answer in CloudTalk Phone, and CloudTalk then calls the contact. Breakcold shows CloudTalk is ringing your agent. Answer there to call the contact.
If the call doesn't start:
- Your CloudTalk agent is offline. You're not signed in to CloudTalk Phone, or your status isn't online. Sign in, set yourself online, then click the number again.
- Your CloudTalk agent is already on a call. Finish that call, then try again.
- CloudTalk may have started this call. Breakcold couldn't confirm the call. Check CloudTalk Phone before you click again, so you don't call twice.
Incoming calls
While you're signed in to CloudTalk Phone in Breakcold, the matching record opens when an inbound call starts ringing. Owners and admins can turn this off under Call handling, with Screen pop, on the Calling settings page.
Recordings
CloudTalk recordings aren't copied into Breakcold. Open a call and click Prepare recording to load it from CloudTalk when you want to listen. If CloudTalk is still processing it, try again a little later. A recording CloudTalk has deleted shows This recording has expired in CloudTalk.
Replace the API key
If you revoked the API key in CloudTalk or created a new one, point at the CloudTalk card, click Replace API key and enter the new key's ID and secret. A key from the same CloudTalk account replaces the old one: your calls, member mapping and webhook stay as they are. Don't disconnect first, because Breakcold can't remove its webhook from CloudTalk with a revoked key.
Breakcold accepts the new key in place only when it can see the webhook it created in CloudTalk. If it can't (a key from another CloudTalk account, or a plan without webhooks), it asks you to disconnect first.
Disconnect
Point at the CloudTalk card, click Disconnect and confirm. Calls stop syncing and Breakcold removes its webhook from CloudTalk. Calls already in Breakcold stay. If you created a Workflow Automation by hand, turn it off in CloudTalk.
Related
Still stuck?