Quickstart

Create an assistant, buy a phone number, and place your first Talkturo test call using the dashboard or API.

Prerequisites

Before you start, make sure you have:

A Talkturo account
Access to the Talkturo dashboard at https://app.talkturo.ai
An API key if you plan to use the API
A credit card if you want to purchase a phone number beyond your included credits

New workspaces start with 10 free credits, so you can complete the initial setup before committing to a larger spend.

Talkturo lets you create an AI voice assistant, connect a phone number, and test a live call in a single setup flow. The steps below follow the fastest path to a working assistant.

Create and Verify Your Account

Create your workspace first, then generate an API key if you want to automate setup.

Open https://app.talkturo.ai/signup and create your account.

When signup succeeds, Talkturo creates your workspace and applies 10 free credits automatically.

Verify your email

Open the verification email from Talkturo and confirm your address.

After verification, you can sign in to the dashboard and access your workspace settings.

Create an API key

In the dashboard, open your account settings and generate an API key.

Talkturo API keys use the format tk_live_... for live environments and tk_test_... for test environments. Copy the key when Talkturo shows it. You will use it in the Authorization header as Bearer tk_test_example_9xmk7q2r.

Build Your First AI Assistant

Create your first assistant from the guided wizard or with a single API request. Both paths create the same underlying assistant record.

The dashboard walks you through a 7-step setup flow:

Configure Assistant — choose a template and name your assistant.
Business Info — add the business context the assistant should use in conversations.
Phone Number — search for or connect a number.
Company — define the company the assistant represents.
Contacts — add or import contacts if you plan to call out.
Campaign — configure an outbound campaign if needed.
Complete — review the setup and finish.

Start at https://app.talkturo.ai/assistants and click New Assistant.

Choose one of these templates:

Outbound Setter
Inbound Support
Follow-up
Custom

When the assistant is created, Talkturo shows it in your assistants list and opens the editor so you can continue setup.

Send a POST request to /api/assistants to create the assistant directly.

curl -X POST https://app.talkturo.ai/api/assistants \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{
    "accountSlug": "acme-sales",
    "name": "Acme Inbound Assistant",
    "templateId": "custom"
  }'

const response = await fetch("https://app.talkturo.ai/api/assistants", {
  method: "POST",
  headers: {
    "Authorization": "Bearer tk_test_example_9xmk7q2r",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    accountSlug: "acme-sales",
    name: "Acme Inbound Assistant",
    templateId: "custom"
  })
});

const assistant = await response.json();
console.log(assistant.id);

Use these request fields:

accountSlug — required workspace slug
name — required assistant name
templateId — optional template identifier, defaults to custom

A successful request returns the new assistant record. Keep the assistant ID because you will use it when assigning phone numbers.

Purchase and Assign a Phone Number

Search for a number first, then purchase it and connect it to your assistant.

Search for a phone number

Use the dashboard phone number flow or call the search API to find available numbers.

curl -X POST https://app.talkturo.ai/api/phone-numbers/search \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "US",
    "searchType": "local",
    "features": ["voice"],
    "limit": 5
  }'

const response = await fetch("https://app.talkturo.ai/api/phone-numbers/search", {
  method: "POST",
  headers: {
    "Authorization": "Bearer tk_test_example_9xmk7q2r",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    country: "US",
    searchType: "local",
    features: ["voice"],
    limit: 5
  })
});

const results = await response.json();
console.log(results);

When the search succeeds, Talkturo returns a list of available numbers. Pick one value from the response for the purchase step.

Purchase the number

Purchase the selected number for your workspace.

curl -X POST https://app.talkturo.ai/api/phone-numbers/purchase \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "+14155550123",
    "accountSlug": "acme-sales"
  }'

const response = await fetch("https://app.talkturo.ai/api/phone-numbers/purchase", {
  method: "POST",
  headers: {
    "Authorization": "Bearer tk_test_example_9xmk7q2r",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    phoneNumber: "+14155550123",
    accountSlug: "acme-sales"
  })
});

const purchase = await response.json();
console.log(purchase);

After purchase, the number appears in your workspace phone number inventory.

Assign the number to your assistant

Connect the purchased number to your assistant and enable call handling.

curl -X POST https://app.talkturo.ai/api/assistants/asst_7f3k29d/telephony/settings \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{
    "accountSlug": "acme-sales",
    "phoneNumberIds": ["pn_4m8x2q1"],
    "inboundEnabled": true,
    "outboundEnabled": true
  }'

const response = await fetch("https://app.talkturo.ai/api/assistants/asst_7f3k29d/telephony/settings", {
  method: "POST",
  headers: {
    "Authorization": "Bearer tk_test_example_9xmk7q2r",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    accountSlug: "acme-sales",
    phoneNumberIds: ["pn_4m8x2q1"],
    inboundEnabled: true,
    outboundEnabled: true
  })
});

const settings = await response.json();
console.log(settings);

When this step succeeds, the assistant can answer inbound calls on the assigned number and place outbound calls if you enabled outbound telephony.

Test Your First Call

Use the built-in test call tools after the number is assigned.

Open your assistant in the dashboard, then go to the Telephony tab to place a test call.

For an inbound test, call the number you assigned to the assistant from your phone. For an outbound test, use the test call controls in the assistant editor. A successful test connects the call and routes audio through the assistant you just configured.

Next Steps

Once your first call works, expand the setup with campaigns, CRM data, and assistant configuration.

AI Assistants

Customize assistant behavior, templates, and telephony settings.

Campaigns

Launch outbound workflows and manage call activity at scale.

CRM Integration

Add contacts and company data that your assistants can use in calls.

Features

Explore the main platform capabilities before moving into advanced setup.

Was this page helpful?