Skip to main content

Documentation Index

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

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

​
SMS Channel

In addition to WhatsApp, Kaanha AI supports two-way SMS messaging via Twilio. SMS conversations appear in the same chat inbox alongside WhatsApp messages.

​
Activating SMS

SMS is activated through your organization settings:
  1. Go to Settings → Connection
  2. Under the SMS section, select your country
  3. Click Activate SMS
Your organization receives a dedicated Twilio phone number for inbound and outbound SMS messaging.

​
Sending SMS

In the Chat inbox, use the channel switcher in the chat header to select SMS before sending. Alternatively, the API accepts a channel parameter: 
POST /api/conversations/[id]/messages
{
  "content": "Hi there! Your appointment is confirmed.",
  "channel": "sms"
}
SMS messages respect the contact’s smsOptedIn flag — opted-out contacts will not receive SMS.

​
Receiving SMS

Inbound SMS messages are received via Twilio webhook: 
POST https://app.kaanha.ai/api/webhooks/twilio/sms
Inbound SMS:
  • Auto-creates a contact if not found (using the phone number)
  • Creates or continues a conversation with channel: "sms"
  • Appears in the Chat inbox alongside WhatsApp messages
  • Routes through the chatbot system (AI agents, flow bots)

​
TCPA Compliance

Kaanha AI handles TCPA-mandated opt-out keywords automatically:
KeywordAction
STOP, STOPALL, UNSUBSCRIBE, CANCEL, QUIT, ENDOpt out — sets smsOptedIn: false, sends confirmation
START, SUBSCRIBE, UNSTOP, YESOpt back in — sets smsOptedIn: true
HELP, INFOAuto-reply with support info
Opt-out records include smsOptOutDate and are permanent until the contact opts back in.
Full Acceptable Use Policy: see /aup for the complete list of prohibited content categories, sender ID rules, and consent requirements. Privacy details: how SMS metadata is processed and retained is documented in /privacy (SMS section).

​
SMS vs WhatsApp Opt-In

SMS opt-in (smsOptedIn) is independent of WhatsApp opt-in (optedIn):
  • A contact can be opted in to WhatsApp but not SMS
  • Opting out of SMS does not affect WhatsApp messaging

​
Viewing SMS Conversations

In the Chat inbox:
  • Conversations via SMS show a purple SMS badge in the conversation list
  • The channel switcher shows SMS as the active channel
  • Message bubbles are identical to WhatsApp messages

​
Deactivating SMS

To release your SMS number and close the Twilio subaccount:
  1. Go to Settings → Connection
  2. Under the SMS section, click Deactivate
  3. Confirm
This releases the phone number. All SMS history is retained in Kaanha AI — only the connection is removed.
  • Voice Agents — telephony AI agents (Premium / Enterprise tier, currently rolling out). Same Twilio account is reused for voice if SMS is already active.
  • WhatsApp Connection — primary messaging channel (Meta Cloud API)

​
Disclosures

  • AI-driven auto-replies on inbound SMS are governed by the AI Disclosure / System Card. When an AI agent handles an SMS conversation, the model used and its limitations are documented there.
  • Acceptable Use Policy: /aup
  • Privacy Policy (SMS section): /privacy