# Skysay

Use [Skysay](https://skysay.ai/) voice AI agents with your **DIDWW numbers** to answer incoming calls, place outbound
calls, and transfer callers to a live person.
Skysay connects to your DIDWW account with a DIDWW API key and configures the SIP trunks and number routing in DIDWW for
you, so you do not create trunks or enter SIP credentials yourself.

- Connect your DIDWW numbers to Skysay with one DIDWW API key.
- Route incoming calls from DIDWW numbers to a Skysay AI agent.
- Let Skysay create and configure the DIDWW SIP trunks for you.

- Place outbound calls through DIDWW with Skysay campaigns.
- Transfer callers from your Skysay agent to a live person.
- Show your DIDWW number as caller ID on outbound calls and transfers.

---

## Before You Begin

- An active DIDWW account is required. [Sign in to DIDWW](https://my.didww.com/users/sign_in) or [Create DIDWW account](https://my.didww.com/users/sign_up#/users/sign_up).
- At least one active **DID number** with capacity to receive incoming calls is required. [Buy Numbers](https://my.didww.com/users/sign_up#/coverage).
- Access to **DIDWW Outbound Trunks** is required for outbound calls and call transfers. See [Get Access to DIDWW Outbound Termination](../../voice/outbound-trunks/get-access.html#user-panel-voice-out-get-access).
- **Outbound trunk management through the API** must be enabled on your DIDWW account. Skysay creates the outbound trunk for outbound calls and call transfers through the DIDWW API. If this feature is not enabled, Skysay can connect incoming calls only. To enable it, contact the DIDWW Sales team at [sales@didww.com](mailto:sales%40didww.com) before you start.
- A [Skysay](https://skysay.ai/) account is required.
- Funds in your Skysay wallet are required for phone calls. The browser credit covers only browser tests. To add funds, in Skysay, go to **Billing**.

Note

This configuration is compatible only with DIDWW API v3 version
`2026-04-16` and earlier, which use
[API key authentication](../../api3/2026-04-16/authentication.html).

---

## 1. Create a DIDWW API Key for Skysay

Create a DIDWW API key in the DIDWW User Panel. Skysay uses the key to list your DIDWW numbers and to configure the
trunks and routing of the number you connect in [3. Connect Your DIDWW Number in Skysay](#skysay-connect).

### Step 1: Open the DIDWW API Page

1. In the [DIDWW User Panel](https://my.didww.com/#/api), go to **APIs > DIDWW API 3**.
2. In **API Keys**, click **Create new API Key**.

![DIDWW API 3 page with the Create new API Key button](../../_images/skysay_apikey1.webp)


**Fig. 1.** APIs > DIDWW API 3: Create new API Key

### Step 2: Create the API Key

1. In **Friendly name**, enter a name for the key (e.g., `Skysay`).
2. Leave **Access IP's** empty. Skysay does not support API keys restricted to IP addresses.
3. Click **Create**.

Warning

The API key gives access to your whole DIDWW account. Share it only with Skysay, and delete the key in **APIs > DIDWW
API 3** if you stop using Skysay.

![Create API Key page with the friendly name Skysay](../../_images/skysay_apikey2.webp)


**Fig. 2.** Creating the API key for Skysay

### Step 3: Copy the API Key

In **API Keys**, find the `Skysay` key and click the copy button next to the masked key.
You paste the key in Skysay in [Step 1](#skysay-enter-key) of the next section.

![Skysay API key in the API Keys list](../../_images/skysay_apikey3.webp)


**Fig. 3.** Copying the Skysay API key



---

## 2. Create a Skysay Agent with Call Transfers

Create the Skysay AI agent that answers calls to your DIDWW number, and enable call transfers to a live person.
If you already have a published agent, you can skip to [Step 4](#skysay-transfer).

### Step 1: Create a New Agent

1. In Skysay, go to **Agents** and click **New AI Agent**.
2. Select a preset (e.g., **Receptionist**) and click **Continue**.

![Skysay Create agent page with the Receptionist preset selected](../../_images/skysay_agent1.webp)


**Fig. 4.** Choosing the Receptionist preset

### Step 2: Set the Agent's Identity

1. Review the **Agent name**, **First message**, and **System prompt** suggested by the preset, and edit them if needed.
2. In **Languages**, select the language of your callers (e.g., **English**).
3. Click **Choose voice stack**.

![Receptionist identity with the agent name, language, first message, and system
prompt](../../_images/skysay_agent2.webp)


**Fig. 5.** Agent identity

### Step 3: Choose the Voice and Create the Agent

1. In **Conversation engine**, keep **Standard** selected.
2. Select a **Voice** from the list. Skysay selects a matching **Speech to text (STT)** provider and **Model**, which you can change.
3. Click **Create only**.

Note

Agents on the **Eleven Realtime** engine cannot use **Transfer to a human**. This guide was tested with the **Standard**
engine.

### Step 4: Add Call Transfers to Your Agent

Call transfers in Skysay are configured as the **Transfer to a human** tool of your agent.
When the agent transfers a call, Skysay places a new call through your DIDWW outbound trunk to the transfer destination,
keeps the agent on the line while it rings, and connects the caller when the person answers.

**Call transfer at a glance**

```
        %%{init: {
  "theme": "base",
  "themeVariables": {
    "fontSize": "14px",
    "primaryColor": "#e0f2fe",
    "primaryBorderColor": "#38bdf8",
    "primaryTextColor": "#1f2d3d",
    "secondaryColor": "#ccfbf1",
    "secondaryBorderColor": "#2dd4bf",
    "secondaryTextColor": "#1f2d3d",
    "lineColor": "#0066cc",
    "textColor": "#1f2d3d",
    "nodeTextColor": "#1f2d3d",
    "edgeLabelBackground": "#ffffff"
  }
}}%%

flowchart LR
    caller["Caller"] -->|"1. Dials your DID number"| didwwIn["DIDWW<br/>Inbound trunk"]
    didwwIn -->|"2. Inbound SIP trunk"| skysay["Skysay<br/>AI agent"]
    skysay -.->|"3. New outbound call<br/>Transfer to a human"| didwwOut["DIDWW<br/>Outbound trunk"]
    didwwOut -->|"4. Call to recipient"| recipient["Person / team<br/>Transfer recipient"]

    classDef endpoint fill:#e0f2fe,stroke:#0066cc,color:#1f2d3d,stroke-width:1.5px
    classDef process fill:#ccfbf1,stroke:#2dd4bf,color:#1f2d3d,stroke-width:1.5px
    class caller,recipient endpoint
    class didwwIn,didwwOut,skysay process
    linkStyle default stroke:#0066cc,stroke-width:1.5px
```

Note

- A transfer creates an additional outbound call through DIDWW. Review the applicable DIDWW and Skysay charges before using transfers.
- Transfers work only after outgoing calls are connected for the number. See [3. Connect Your DIDWW Number in Skysay](#skysay-connect).
- The person who receives the transfer sees your DIDWW number as the caller ID.

`+15105550199` is a fictional number used only as an example for demonstration purposes. Replace it with your actual
transfer destination number.

1. In your agent, open **Tools**.
2. Select **Transfer to a human**.
3. In **Transfer destination number**, enter the number in E.164 format, starting with `+` and the country code (e.g., `+15105550199`). Do not use a DIDWW number that is connected to your Skysay agent, or the transferred call returns to your agent.

Note

The agent decides when to transfer from its instructions. By default, it transfers when the caller asks for a person, or
after the caller accepts an offer to transfer.
Skysay makes one transfer attempt per call. If nobody answers, or the line is busy, the caller stays with the agent.

![Transfer to a human tool enabled with a destination number](../../_images/skysay_transfer1.webp)


**Fig. 6.** Transfer to a human with the transfer destination number

### Step 5: Publish the Agent

1. Click **Publish changes**.
2. In the **Publish this AI agent** window, click **Publish**.

---

## 3. Connect Your DIDWW Number in Skysay

Import your DIDWW number in Skysay with the DIDWW API key. Skysay creates the DIDWW trunks, assigns the inbound trunk to
the number, and routes incoming calls to your agent.

### Before You Begin

- The DIDWW API key from [1. Create a DIDWW API Key for Skysay](#skysay-api-key) is required.
- A published Skysay agent is required. See [2. Create a Skysay Agent with Call Transfers](#skysay-agent).
- Connecting incoming calls replaces the current inbound trunk or trunk group of the number in DIDWW. Other numbers do not change. Do not edit the routing of the number in DIDWW while Skysay connects it.

### Step 1: Enter the DIDWW API Key

1. In Skysay, go to **Numbers** and click **Import a number**.
2. In **Carrier**, select **DIDWW**.
3. In **DIDWW API key**, paste the API key.
4. Click **List my numbers**.

Note

Listing your numbers does not change anything in DIDWW. Skysay uses the API key during setup only and clears it when you
finish or close the window.

![Import from your carrier window with DIDWW selected and the API key entered](../../_images/skysay_import1.webp)


**Fig. 7.** Entering the DIDWW API key (key masked)

### Step 2: Select Your DIDWW Number

Next to the DIDWW number you want to connect, click **Select**.
To find a number on a large account, enter the full number in the search box and click **Search**.

![List of DIDWW numbers in the Import from your carrier window](../../_images/skysay_import2.webp)


**Fig. 8.** Selecting the DIDWW number (example numbers)

### Step 3: Choose the Agent and Connect Outgoing Calls

1. In **AI agent for incoming calls**, select your agent (e.g., `AI receptionist`).
2. Select **Connect outgoing calls**. Outgoing calls are required for outbound calls and call transfers.
3. Click **Review setup**.

Note

To keep the current routing of the number for now, select **Set up incoming later**.
To connect it later, open the number in Skysay, click **Re-enter API key to manage setup**, and enter the API key again.

![AI agent for incoming calls selected and Connect outgoing calls enabled](../../_images/skysay_import3.webp)


**Fig. 9.** Choosing the agent and connecting outgoing calls

### Step 4: Review and Connect the Number

1. Check the **Current incoming route** of the number. Skysay replaces it with the selected agent.
2. Select **Replace this number's incoming route with the selected Skysay AI agent.**
3. Click **Connect this number**.

![Review of the current incoming route and the planned changes](../../_images/skysay_import4.webp)


**Fig. 10.** Reviewing and connecting the number

### Step 5: Check the Result

When the setup is complete, Skysay shows **Number connected**, **Incoming setup complete**, and **Outgoing configured**.
These messages confirm the saved setup. They do not confirm that a call has succeeded. Test the configuration in [4.
Test the Configuration](#skysay-test).

![Number connected with incoming setup complete and outgoing configured](../../_images/skysay_import5.webp)


**Fig. 11.** Number connected for incoming and outgoing calls

In Skysay, the number is **Active**, with **Call in** and **Call out** enabled, and routes incoming calls to your agent.

![Active DIDWW number in Skysay with Call in and Call out enabled](../../_images/skysay_number1.webp)


**Fig. 12.** Connected DIDWW number in Skysay (example number)

After you connect a number, Skysay creates and configures the following in your DIDWW account:

| Resource | Configuration |
| --- | --- |
| Inbound trunk | A SIP trunk named `Skysay incoming nimp_...` that delivers calls to the Skysay SIP server over UDP, with **Authorization** enabled. Skysay assigns the trunk to the number in place of its previous inbound trunk or trunk group. See [Inbound SIP trunk settings](../../voice/inbound-trunks/sip-trunks/sip-trunk-settings-reference.html#inbound-sip-trunks-settings-reference). |
| Outbound trunk | A trunk named `Skysay outgoing nimp_...` with **Credentials & IP-Based** authentication that accepts calls only from Skysay. **Allowed CLI(s)** contains only the connected number, and **On CLI mismatch** is set to **Reject call**. The **Capacity limit** is `1` concurrent call, and the **24 hour limit (USD)** is `3000`. See [CLI settings](../../voice/outbound-trunks/outbound-trunk-reference.html#outbound-trunk-cli-settings) and the [Outbound trunk reference](../../voice/outbound-trunks/outbound-trunk-reference.html). |
| DID number | The inbound trunk is assigned to the number. The SMS trunk of the number does not change. See [Assign a voice trunk](../../phone-numbers/my-numbers/how-to-guides/assign-voice-trunk.html#user-panel-assign-trunk). |

Note

- The import connects voice calls only. It does not connect SMS, even if your DIDWW number supports SMS.
- Other DID numbers and unrelated trunks do not change.

---

## 4. Test the Configuration

Verify that inbound calling, outbound calling, and call transfers are working as expected.

### Inbound calls

1. Call your DIDWW number.
2. Check that the agent answers with its first message and that both parties can hear each other.
3. In Skysay, go to **Calls** and check that the call appears as **Inbound** with the outcome **Completed**.

### Outbound calls

Place outbound calls with a Skysay campaign. A campaign calls a list of your own customers, or people who agreed to be
called, within the hours you choose.

1. In Skysay, go to **Tools & Operations > Campaigns** and click **New campaign**.
2. In **Contacts**, upload a CSV or Excel file, or paste rows with a phone number column in E.164 format (e.g., `+19085550100`). Select the **Consent basis** and click **Continue**.
3. In **Agent & numbers**, enter a **Campaign name**, select your agent, and select your DIDWW number in **Caller ID numbers**. Click **Continue**.
4. In **Schedule & retries**, set the calling hours and retries, and click **Review**.
5. Click **Create and launch**, and answer the call on the destination phone.
6. Check the caller ID and that both parties can hear each other.

Note

Calls go out only inside the calling hours of the campaign. By default, the hours apply in each contact's local time.
To place outbound calls with the Skysay API instead, see [Make your first outbound
call](https://skysay.ai/docs/make-first-outbound-call).

### Call transfers

1. Call your DIDWW number and wait for the agent to answer.
2. Ask the agent to transfer you to a person.
3. Answer the call at the transfer destination.
4. Check that both parties can hear each other after the agent connects the call.
5. In Skysay, go to **Calls**, select the call, and check the `transfer_to_human` tool call in the transcript.

Note

- Skysay shows the transcript, tool calls, recording, and outcome of each call in **Calls**.
- You can review call activity and verify call status or error codes in the DIDWW **Inbound** and **Outbound Call Logs**. Outbound calls and transfers appear in the **Outbound Call Logs** as calls through the `Skysay outgoing` trunk, with your DIDWW number as the caller ID. See [Inbound Call Logs](../../logs-analytics/call-logs/inbound-logs.html#inbound-cdr-logs) and [Outbound Call Logs](../../logs-analytics/call-logs/outbound-logs.html#outbound-cdr-logs) for more details.

---

## Troubleshooting

Skysay shows **Carrier access was denied** when you connect outgoing calls

This is the Skysay error shown when DIDWW rejects the outbound trunk that Skysay tries to create. It means that outbound
trunk management through the API is not enabled on your DIDWW account.
Incoming calls can still be connected without outgoing calls.

To enable outbound trunk management through the API, contact the DIDWW Sales team at
[sales@didww.com](mailto:sales%40didww.com).
Then, in Skysay, open the number, click **Re-enter API key to manage setup**, enter the API key, and connect outgoing
calls.

The agent says that nobody is available, and the transfer destination does not ring

Skysay places transfers through the DIDWW outbound trunk. Check that:

- The number shows **Outgoing configured** in Skysay. If it does not, connect outgoing calls. See [3. Connect Your DIDWW Number in Skysay](#skysay-connect).
- The **Transfer destination number** is in E.164 format, starting with `+` and the country code.
- Calls to the destination are allowed for your DIDWW account and in your Skysay workspace.

A transfer that DIDWW does not receive does not appear in the DIDWW **Outbound Call Logs**.

An outbound call or transfer is rejected by DIDWW

Check the call in the DIDWW **Outbound Call Logs**, and then check the following on your DIDWW account and the `Skysay
outgoing` trunk:

- Your DIDWW account balance is sufficient.
- Calls to the destination are allowed for your account.
- The caller ID is the connected DIDWW number. The trunk allows only this number and rejects calls with any other caller ID.
- The trunk has not reached its **Capacity limit** of `1` concurrent call, for example because of another outbound call or transfer in progress.
- The trunk has not reached its **24 hour limit (USD)**.

The call is rejected with **Dedicated channels capacity exceeded**

The DID number has no capacity for incoming calls. In the DIDWW **Inbound Call Logs**, the call has the status `CAPACITY
EXCEEDED`.
Add capacity to the number, for example by assigning it to a capacity group. See
[Capacity](../../phone-numbers/capacity/index.html).

The call is rejected with **Busy Here**

Skysay can reject incoming calls when your Skysay wallet has no funds. In Skysay, go to **Billing** and check your
wallet balance. Add funds if needed.

**The carrier has not confirmed the previous step** when you connect a number

A previous setup of the number was not completed. Do not start a new import of the same number.
Contact [Skysay support](mailto:support%40skysay.ai) with the number.

Incoming calls stop reaching Skysay after you disconnect the number

**Disconnect from Skysay** stops Skysay from accepting calls for the number. It does not delete the trunks in DIDWW and
does not restore the previous routing of the number.
To route calls elsewhere, assign another inbound trunk to the number in DIDWW. See [Assign a voice
trunk](../../phone-numbers/my-numbers/how-to-guides/assign-voice-trunk.html#user-panel-assign-trunk).

Skysay does not receive SMS sent to the DIDWW number

The DIDWW import connects voice calls only. SMS sent to the number is still delivered to the SMS trunk configured in
DIDWW.

For Skysay diagnostics, see [Why calls fail](https://skysay.ai/docs/why-calls-fail).

## Additional Resources

- [Skysay: DIDWW, connect with one API key](https://skysay.ai/docs/import-a-number#didww-connect-with-one-api-key)
- [Skysay: Transfer to a human](https://skysay.ai/docs/transfer-to-a-human)
- [Skysay: Make your first outbound call](https://skysay.ai/docs/make-first-outbound-call)
- [Skysay: Launch a campaign](https://skysay.ai/docs/launch-a-campaign)
- [Skysay: Billing](https://skysay.ai/docs/billing)
