Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nonhumans.ai/llms.txt

Use this file to discover all available pages before exploring further.

Your agent gets a dedicated phone number the moment it is provisioned — no carrier contracts, no SIM cards, no third-party messaging account to manage. The phone primitive lets your agent send and receive SMS, make and receive voice calls, and meet users on the messaging platforms where they already spend time.

​
What Phone Provides

Dedicated Number

A real phone number assigned exclusively to your agent. It can send and receive calls and SMS from any phone worldwide.

SMS

Programmatic send and receive of text messages, with delivery receipts and inbound message queuing.

Voice Calls

Initiate outbound calls with a script or dynamic text-to-speech, and handle inbound calls with programmable responses.

Messaging Channels

Connect WhatsApp, Telegram, and Slack handles so your agent is reachable wherever your users prefer.

​
Getting Started

Phone capabilities are configured from the dashboard. Once your agent is created, navigate to Agent → Phone to view your assigned number and enable the channels you need. No code is required to receive your number — it is provisioned automatically.
Phone numbers are currently available in the United States, Canada, United Kingdom, Australia, and most of the EU. Voice calling is supported in all available regions. Check the availability page for the latest country list.

​
SMS

Your agent can send and receive SMS from its dedicated number. Inbound messages are queued and retrievable via the API, and you can configure a webhook to react to them in real time. Use cases include:
  • Verification codes — send OTP codes from a verified number for higher deliverability and user trust
  • Automated notifications — push order updates, appointment reminders, or system alerts without human involvement
  • Inbound command interface — let authorised users control your agent by texting commands to its number

​
Voice Calls

Your agent can initiate outbound calls using a text-to-speech script, and can handle inbound calls with programmable response flows — including keypress menus and call forwarding to a human when needed.
Build inbound call flows that escalate gracefully: let your agent handle routine queries autonomously and forward to a human representative only when the caller’s intent is outside the agent’s scope.

​
Connecting Messaging Channels

Beyond SMS and voice, you can connect your agent to the messaging platforms your users prefer. Channel setup is done from the dashboard under Phone → Channels.
1

WhatsApp

Link your agent’s number to a WhatsApp Business Account from Phone → Channels → WhatsApp. Once verified, your agent can send and receive WhatsApp messages using its dedicated number.
2

Telegram

Create a Telegram bot via BotFather, then paste the bot token into Phone → Channels → Telegram. Your agent will appear as that bot to Telegram users.
3

Slack

Install the Nonhumans Slack app into your workspace from Phone → Channels → Slack. Your agent can then post to channels or DM users directly.

​
Use Cases

Two-Factor Auth

Your agent can act as the sender for OTP codes — verified deliverability with real phone numbers means higher trust than shared short codes.

Automated Notifications

Push time-sensitive alerts (order updates, system alerts, appointment reminders) via SMS without human intervention.

Agent-to-Human Outreach

An agent conducting research or sales outreach can call or text prospects directly, escalating to a human when the conversation requires it.

Inbound Command Interface

Let authorised users control an agent by texting commands to its number — a simple, accessible alternative to a dashboard.

​
Geographic Availability

WhatsApp availability depends on your WhatsApp Business Account country registration. Voice calling regulations vary by country — consult your local telecommunications authority before enabling outbound voice in a new region.
Automated voice calls and unsolicited SMS are subject to local telecommunications regulations (TCPA in the US, PECR in the UK, and equivalents elsewhere). You are responsible for ensuring your agent’s communications comply with applicable law, including maintaining opt-in records for marketing messages.