Rosi
Rosi Calls Telnyx details
Setup Guide

Set up
Rosi Calls
with Telnyx.

Use this guide when you want Rosi to place bounded phone calls on your behalf. This is the default bring-your-own-account path for phone calling in Rosi.

Requires One Telnyx account and one Telnyx API key.
Not required No Twilio, ElevenLabs, or OpenRouter setup for the default path.
Works for Message delivery, table reservations, and bounded appointment calls.
Overview

What Rosi Calls uses today

Provider

Telnyx is the default one-account setup path for phone calling.

Voice

The default path uses the provider voice. You do not need to configure a separate voice service.

Number

Rosi calls from your active Telnyx number, not from a shared product-owned phone line.

Setup inside Rosi

The app only needs your Telnyx API key for the capability page.

Rosi Calls is a product capability, not a connector. You are not linking a Gmail-style account surface inside the app. You are enabling a phone-calling feature with your own provider account.
Step by step

How to set it up

1

Create your Telnyx account

Start at telnyx.com and finish the normal account signup flow.

2

Get a phone number

Open Search & Buy Numbers and buy or activate a number that can place outbound calls in the countries you care about.

Mission Control Portal → Numbers → Search & Buy Numbers
  • Make sure the number is active.
  • If you need a local country number, choose that during number purchase.
  • If you want a number outside the US, check country requirements first.
3

Create an API key

Open API Keys, click Create API Key, and copy the full key immediately.

Mission Control Portal → Your name in the top-right corner → API Keys
  • Name it something obvious like Rosi Calls.
  • Telnyx only shows the key once after creation.
  • If the portal layout looks different, use the official API key guide.
4

Open the Rosi app and go to Rosi Calls

In the Mac app, open the dedicated Rosi Calls capability page, paste the Telnyx API key, and save it.

5

Let Rosi validate the setup

Rosi checks the key and confirms whether your number is ready. The saved phone assistant is prepared lazily on the first live call.

If Rosi says the setup still needs attention, the usual reason is that your Telnyx account has no active phone number yet.
Verification

How to test the first call

Once the capability page shows Ready, try a simple bounded request like:

  • call my wife and tell her I'll be 20 minutes late
  • call Luigi and book a table for 2 tomorrow at 3pm

Rosi should place the call, watch for completion, and report the result back into the same conversation.

Common issues

What to check if setup fails

The API key is rejected

Make sure you copied the full Telnyx API key and did not include extra spaces before or after it.

No active phone number found

Go back to Telnyx and confirm your number is active and able to place outbound calls.

The call still cannot start

Check whether your Telnyx account and number support the country you are trying to call.

You want a custom voice

That is not required for the default setup path. Start with the default provider voice first.

If you are still blocked, send the exact Rosi Calls error from the capability page when asking for help. That is usually enough to narrow the issue quickly.