Skip to main content
Noorle provisions the phone number for you. You do not bring a Twilio account, you do not configure a webhook, and you do not register anything yourself.

​
Setup

1

Open the SMS drawer

Agents → (agent) → Channels → SMS → Set up.
2

Search for a number

Optionally enter a 3-digit area code, then Search numbers. The results show the number, a friendly name, and its locality and region.
3

Provision

Pick a number and click Provision. The confirm button reads **Provision · 3/mo∗∗—thedrawerstatesthechargeinline:"Provisioninganumbercosts3/mo** — the drawer states the charge inline: "Provisioning a number costs 3/month, billed to this account.”
4

Enable it

Provisioning stores the channel but does not enable it. Flip the enable switch.
5

Confirm

The status chip should read Connected. Text the number and check you get a reply.
Provisioning is durable and holds a lock for the duration. A second attempt while one is in flight returns “Another SMS number provision is already in progress for this agent.” One number per agent. A second provision returns “This agent already has an SMS number configured.” To change numbers, remove the channel and provision a new one.

​
Removing a number

The Portal is explicit: this releases the phone number and stops its monthly billing, and the number cannot be recovered.

​
How inbound works

Twilio posts to https://hooks.noorle.com/webhooks/sms/{agent_id}. Noorle verifies Twilio’s HMAC signature before looking the agent up, so a forged request never reaches an agent lookup. A valid signature for an agent that no longer exists returns 503 rather than 404, so Twilio retries rather than giving up. You configure none of this.

​
Limits

​
Cost

  • The number: $3.00 per month, billed to the account, from the moment it is provisioned until it is released.
  • Messages: metered per message.
See noorle.com/pricing.

​
Autonomy

SMS is an unattended surface. A tool call that would pause for approval is denied. See Autonomy and approvals.

​
Linking users

Link a member’s phone number under Settings → Users → (user) → Linked Platforms. SMS requires verification: the platform texts a 6-digit code, which expires in 10 minutes, and the user enters it. The identity shows as Pending until then. Telegram and Slack link without this step; SMS does not.

​
Troubleshooting

​
Next