Copy page

Developers

Send Your First Message

Follow this tutorial to send your first message using the Qwetty API.

Prerequisites

• A connected channel (WhatsApp, Instagram, or Web Chat)
• An API key — Create one here

Step 1: List your chats

First, find an existing conversation:

Code
curl -X GET "https://api.qwetty.com/api/v1/chats?page=1&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

Code
{
  "data": [
    {
      "id": "chat_abc123",
      "name": "John Doe",
      "type": "PRIVATE",
      "channelId": "ch_xyz"
    }
  ],
  "meta": {
    "total": 42,
    "per_page": 5,
    "current_page": 1,
    "last_page": 9
  }
}

Step 2: Send a text message

Using a chat ID from the previous step:

Code
curl -X POST "https://api.qwetty.com/api/v1/chats/chat_abc123/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Hello from the API!"}'

Response (the created message under data, plus a message status string):

Code
{
  "data": {
    "id": "msg_def456",
    "chatId": "chat_abc123",
    "type": "TEXT"
  },
  "message": "Message sent"
}

Step 3: Send a template message

For WhatsApp (outside the 24-hour window), use a template. The endpoint takes a phoneNumber and templateId (not a chat ID):

Code
curl -X POST "https://api.qwetty.com/api/v1/send-template" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "+15551234567",
    "templateId": "tmpl_ghi789"
  }'

You can also pass an optional channelId and a templateVariables object for templates with variables.

Step 4: View message history

Fetch messages from a chat:

Code
curl -X GET "https://api.qwetty.com/api/v1/chats/chat_abc123/messages?page=1&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

What's next?

• API Reference — Full endpoint documentation
• Webhooks — Get notified when new messages arrive
• Error Handling — Handle API errors gracefully