Click to Chat
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Click to Chat lets anyone start a conversation with you on Arattai without saving your phone number in their contacts. Share a link and anyone can message you directly.
Click to Chat links require no API authentication and can be constructed by any application or AI assistant using the URL patterns on this page.
What Happens When Someone Opens the Link
When a user clicks or taps a Click to Chat link:
- Arattai opens a chat with the target user. The person who clicks the link does not need to save the phone number.
- If a pre-filled message is included in the link via the
textquery parameter, that message appears automatically in the chat composer. - The user can edit the pre-filled message before sending it.
Click to Chat URL Formats
There are two ways to target a recipient in a Click to Chat link: using a phone number or using an Arattai username.
Using a Phone Number
Use the recipient's phone number including the country code. Do not include spaces in the number.
| Variant | URL Pattern | Example |
|---|---|---|
| Basic | https://aratt.ai/message/<cc>-<phone> |
https://aratt.ai/message/91-9999999999 |
| With pre-filled message | https://aratt.ai/message/<cc>-<phone>?text=<message> |
https://aratt.ai/message/91-9999999999?text=Hello |
Notes:
- Always include the country code (e.g.,
91for India,1for USA). - Separate the country code from the phone number with a hyphen (
-). - Do not include spaces.
Using a Username
If the target user has set an Arattai username, you can use it instead of a phone number. Usernames are prefixed with @.
| Variant | URL Pattern | Example |
|---|---|---|
| Basic | https://aratt.ai/message/@<username> |
https://aratt.ai/message/@johndoe |
| With pre-filled message | https://aratt.ai/message/@<username>?text=<message> |
https://aratt.ai/message/@johndoe?text=Hello |
Using the text Query Parameter
Append ?text=<message> to any Click to Chat URL to pre-fill the chat composer with a message. The recipient does not receive anything until the user reviews and taps Send.
Simple message
https://aratt.ai/message/@username?text=Hello
URL-encoded message
If the message contains spaces or special characters, it must be URL-encoded. Replace spaces with %20. Special characters such as &, +, #, and = must also be percent-encoded. When generating links in JavaScript, prefer encodeURIComponent(message) instead of manual string replacement.
https://aratt.ai/message/@username?text=Hi%20I%20need%20help
Encoding reference
| Character | URL-encoded form |
|---|---|
| Space | %20 |
! | %21 |
? | %3F |
& | %26 |
= | %3D |
# | %23 |
+ | %2B |
Generating Links Programmatically
Code samples for building a Click to Chat link.
JavaScript
function buildArattaiChatLink(target, message) {
var base = "https://aratt.ai/message/" + target;
if (!message) return base;
return base + "?text=" + encodeURIComponent(message);
}
// Example: phone number only
buildArattaiChatLink("91-9999999999");
// => https://aratt.ai/message/91-9999999999
// Example: username with pre-filled message
buildArattaiChatLink("@johndoe", "Hi I need help");
// => https://aratt.ai/message/@johndoe?text=Hi%20I%20need%20help
Python
from urllib.parse import quote
def build_arattai_chat_link(target, message=None):
base = "https://aratt.ai/message/" + target
if message:
return base + "?text=" + quote(message)
return base
# Example: phone number only
build_arattai_chat_link("91-9999999999")
# => https://aratt.ai/message/91-9999999999
# Example: username with pre-filled message
build_arattai_chat_link("@johndoe", "Hi I need help")
# => https://aratt.ai/message/@johndoe?text=Hi%20I%20need%20help
cURL (verify from terminal)
curl -I "https://aratt.ai/message/91-9999999999?text=Hello"
Chat on Arattai Button
Use the official Chat on Arattai button when placing a Click to Chat link in a UI so users recognise it.
Best practices:
- Use the official button design without modifying it.
- Always use the latest version of the button asset.
- Ensure the button is clearly visible and has sufficient contrast against its background.
- Wrap the button in an anchor tag that links to the Click to Chat URL.
Download button designs (PNG/SVG/EPS)
Button variants
Choose the variant that best fits your background. Available in Small, Medium, and Large sizes.
| Yellow | Black | White |
|---|---|---|
HTML embed example
<a href="https://aratt.ai/message/@username" target="_blank" rel="noopener noreferrer">
<img src="/path/to/chat-on-arattai-btn.png"
alt="Chat on Arattai" style="height:48px;" />
</a>
Note: Download the button image (chat-on-arattai-btn.png or the SVG variant) from the design assets zip above, host it on your own server/CDN, and update the src path above to point to your hosted copy.
Where Can You Use Click to Chat
You can place a Click to Chat link or button anywhere you want users to initiate a conversation:
| Surface | Example use |
|---|---|
| Websites & landing pages | Add a "Chat with us" CTA button linked to your support handle. |
| Social media profiles & bios | Include the link in Instagram, LinkedIn, or X bio fields. |
| Email signatures | Let email recipients start an Arattai chat with a single click. |
| Marketing campaigns & ads | Link ads directly to a chat conversation. |
| QR codes | Encode the link in a QR code for print materials. |
| Chatbots & AI assistants | Generate a link for a given phone number or username programmatically. |
Quick Reference
| Goal | URL |
|---|---|
| Open chat with phone number | https://aratt.ai/message/<cc>-<phone> |
| Open chat with username | https://aratt.ai/message/@<username> |
| Open chat with pre-filled message (phone) | https://aratt.ai/message/<cc>-<phone>?text=<encoded_msg> |
| Open chat with pre-filled message (username) | https://aratt.ai/message/@<username>?text=<encoded_msg> |
Base domain: https://aratt.ai
Authentication required: None. These are public links.