Introduction

View as Markdown

Dial gives your AI agent a phone number. With one account and an API key, an agent can send SMS, place AI voice calls, and receive inbound messages such as one-time codes — from the command line, an SDK, or the REST API.

What you can do

  • Send SMS — text any phone number from one of your Dial numbers.
  • Place AI voice calls — dial a number and let an AI voice agent hold the conversation from a system prompt you provide.
  • Receive an SMS — capture replies and one-time codes by consuming your account’s event stream.
  • Manage numbers — provision and list the phone numbers on your account.

How agents use Dial

There are two integration styles, both covered in Using Dial from an agent:

  • CLI — agents that can run shell commands call dial. Every command accepts --json for machine-readable output.
  • SDKs — agents written in code import the Node, Python, or LangChain SDK.

Both go to the same REST API, so you can mix them freely.