Copy page

Pengembang

Kirim Pesan Pertama

Ikuti tutorial ini untuk mengirim pesan pertama Anda menggunakan API Qwetty.

Prasyarat

• Channel yang terhubung (WhatsApp, Instagram, atau Web Chat)
• API key — Buat di sini

Langkah 1: Daftar chat Anda

Pertama, temukan percakapan yang sudah ada:

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

Respons:

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
  }
}

Langkah 2: Kirim pesan teks

Menggunakan ID chat dari langkah sebelumnya:

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": "Halo dari API!"}'

Respons (pesan yang dibuat di bawah data, ditambah string status message):

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

Langkah 3: Kirim template pesan

Untuk WhatsApp (di luar jendela 24 jam), gunakan template. Endpoint memerlukan phoneNumber dan templateId (bukan ID chat):

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"
  }'

Anda juga dapat mengirim channelId opsional dan objek templateVariables untuk template dengan variabel.

Langkah 4: Lihat riwayat pesan

Ambil pesan dari 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"

Langkah selanjutnya

• Referensi API — Dokumentasi endpoint lengkap
• Webhook — Mendapatkan notifikasi saat pesan baru masuk
• Penanganan Error — Menangani error API dengan tepat