Lewati ke konten
OmniChannels.ai

Asisten dan agen AI

Claude Code + OmniChannels.ai: bangun dan uji pesan langsung dari terminal Anda

Hubungkan via MCPHubungkan via API & webhookDiperbarui

Singkatnya

Claude Code terhubung ke OmniChannels.ai dengan satu perintah: claude mcp add --transport http yang mengarah ke https://mcp.broadnet.me/mcp dengan header Authorization: Bearer. Setelah itu, Claude Code dapat mengirim pesan uji, menampilkan daftar template WhatsApp, dan membaca laporan pengiriman (DLR) sambil menulis kode integrasi Anda dari spesifikasi OpenAPI 3.1 kami. Tim dapat berbagi server lewat .mcp.json, dan aturan izin (permission rules) menentukan tools mana yang berjalan tanpa konfirmasi.

Yang bisa Anda lakukan

  • Tulis kode dari template yang sebenarnya

    Claude Code membaca template WhatsApp Anda yang sudah disetujui lewat MCP, lalu menulis fungsi dengan variabel yang persis dibutuhkan setiap template.

    Coba tanyakan

    “Gunakan tools omnichannels untuk menampilkan daftar template WhatsApp saya yang sudah disetujui, lalu tulis fungsi TypeScript yang mengirim order_update beserta field yang dibutuhkannya.”

  • Bangun webhook handler

    Arahkan Claude Code ke panduan webhook, dan ia akan menulis endpoint yang menyimpan status pengiriman serta pesan masuk, dengan toleransi terhadap field yang berbeda di tiap kanal.

    Coba tanyakan

    “Tulis webhook handler Express yang mencatat status SUBMITTED, SENT, DELIVERED, READ, FAILED, dan REJECTED berdasarkan ID pesan, dan mencatat field yang tidak dikenal ke log alih-alih gagal.”

  • Buat klien bertipe dari spesifikasi

    Dengan spesifikasi OpenAPI tersimpan di repositori Anda, Claude Code memakai path dan field yang tepat, bukan menebak-nebak.

    Coba tanyakan

    “Dengan docs/omnichannels-openapi.yaml, tulis modul Python yang mengirim SMS lewat POST /sms/sendSms, lalu daftar setiap field yang dipakai beserta tipenya dari spesifikasi.”

  • Uji end to end di nomor Anda sendiri

    Claude Code mengirim pesan uji setelah Anda menyetujui pemanggilan tool, lalu memeriksa laporan pengiriman untuk memastikan alur kode Anda berfungsi.

    Coba tanyakan

    “Kirim SMS uji dari OmniDemo ke nomor saya 447700900123, lalu periksa laporan pengirimannya.”

  • Debug pengiriman yang gagal

    Tools baca (read) memungkinkan Claude Code membandingkan laporan pengiriman dengan log Anda dan menelusuri kegagalan hingga ke permintaan penyebabnya.

    Coba tanyakan

    “Baca laporan pengiriman untuk kampanye kemarin, ringkas alasan kegagalannya, dan periksa kode retry kita berdasarkan panduan error.”

Cara koneksinya

Hubungkan via MCPHubungkan via API & webhook

Claude Code menambahkan server MCP jarak jauh dengan claude mcp add --transport http dan header Authorization. Shell Anda mengisi token dari environment variable saat perintah dijalankan. Untuk tim, file .mcp.json tingkat proyek memungkinkan setiap developer memakai token masing-masing lewat ${BROADNET_TOKEN}, dan Claude Code meminta setiap orang menyetujui server tersebut sebelum digunakan.

MCP mencakup tindakan pada akun Anda: mengirim pesan uji, membaca template, dan membaca laporan pengiriman (DLR). Untuk menulis kode integrasi, berikan spesifikasi OpenAPI 3.1 kami kepada Claude Code sebagai sumber acuan endpoint dan field, ditambah panduan webhook, karena payload webhook tidak ada di spesifikasi. Aturan izin seperti mcp__omnichannels__get_* membuat tools baca berjalan tanpa konfirmasi, sementara tools kirim tetap meminta persetujuan.

  • Perintah: claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp
  • Setup tim: commit .mcp.json dengan Bearer ${BROADNET_TOKEN}, jangan pernah menyimpan key
  • Aturan izin menamai tools sebagai mcp__omnichannels__<tool>
  • Spesifikasi OpenAPI 3.1 di /developers/openapi.json untuk field permintaan yang tepat
  • SMS tunggal memakai JSON; pengiriman massal dan sebagian besar kanal lain memakai multipart/form-data

Atur integrasinya

  1. 1

    Minta akses API

    Minta akses uji coba dan terima token API. Pengiriman uji hanya menuju nomor Anda sendiri yang sudah terverifikasi.

  2. 2

    Ambil key sementara

    Di portal admin, buka Integrations, lalu MCP Integration, pilih Get temporary key, dan ekspor sebagai BROADNET_TOKEN.

    Panduan: MCP server for AI agents
  3. 3

    Tambahkan server

    Jalankan claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp dengan header Authorization, atau commit .mcp.json proyek untuk tim Anda, lalu periksa dengan /mcp.

    Panduan: Use the MCP server with Claude Code
  4. 4

    Atur aturan izin

    Izinkan tools baca seperti mcp__omnichannels__get_* jika diinginkan, biarkan setiap tool kirim tetap meminta konfirmasi, dan tolak tools yang tidak dibutuhkan proyek.

    Panduan: Use the MCP server with Claude Code
  5. 5

    Tambahkan spesifikasi OpenAPI

    Unduh openapi.yaml ke repositori Anda, lalu minta Claude Code memakainya untuk path endpoint, field, dan enum.

    Panduan: OpenAPI 3.1 spec
  6. 6

    Uji di nomor Anda sendiri

    Minta Claude Code mengirim pesan uji ke nomor Anda yang sudah terverifikasi, lalu membaca kembali laporan pengirimannya.

Dokumentasi vendor

Claude Code adalah merek dagang milik pemiliknya. OmniChannels.ai tidak berafiliasi dengan atau didukung oleh Claude Code; halaman ini menjelaskan koneksi yang dibangun dengan fitur MCP, HTTP, atau webhook milik Claude Code sendiri.

Contoh alur kerja

Bagaimana permintaan umum berpindah dari Claude Code ke pelanggan Anda dan kembali lagi.

  1. 01

    Claude Code

    Menulis integrasi Anda dan memanggil tools saat diminta

  2. 02

    MCP dan API OmniChannels.ai

    Tools MCP untuk pengujian; kode Anda memanggil REST API

  3. 03

    Ponsel uji Anda

    SMS atau WhatsApp uji ke nomor Anda yang sudah terverifikasi

  4. 04

    Webhook handler Anda

    Menerima status pengiriman dan pesan masuk

1. Claude Code: Menulis integrasi Anda dan memanggil tools saat diminta 2. MCP dan API OmniChannels.ai: Tools MCP untuk pengujian; kode Anda memanggil REST API 3. Ponsel uji Anda: SMS atau WhatsApp uji ke nomor Anda yang sudah terverifikasi 4. Webhook handler Anda: Menerima status pengiriman dan pesan masuk

Pertanyaan

Apakah ada plugin resmi OmniChannels.ai untuk Claude Code?

Tidak ada. Claude Code terhubung lewat dukungan standarnya untuk server MCP jarak jauh, memakai endpoint publik kami dan token API Anda, serta membaca spesifikasi OpenAPI publik kami seperti file lain di repositori Anda.

Bagaimana cara berbagi server dengan tim tanpa membagikan key?

Commit .mcp.json tingkat proyek yang header Authorization-nya memakai ${BROADNET_TOKEN}. Setiap developer mengatur variabel itu di shell masing-masing, dan Claude Code meminta mereka menyetujui server proyek sebelum memakainya.

Bisakah Claude Code mengirim pesan tanpa bertanya?

Secara default, Claude Code meminta konfirmasi sebelum memakai tool MCP. Pertahankan ini untuk tools kirim, karena setiap pengiriman adalah pesan nyata yang dikenai biaya. Izinkan hanya tools baca di aturan izin Anda, dan periksa nama tools di /mcp terlebih dahulu karena bergantung pada versi server dan akun Anda.

Sebaiknya memakai MCP atau REST API di produk saya?

Gunakan MCP agar Claude Code dapat menguji dan memeriksa akun Anda selama pengembangan. Kode yang Anda rilis sebaiknya memanggil REST API secara langsung dengan token dari secrets store Anda, memakai spesifikasi OpenAPI untuk field yang tepat.

Dapatkan akses API dan MCP

Beri tahu kami kanal, negara, dan kasus penggunaan Anda. Seorang engineer akan menerbitkan kredensial uji coba dan memverifikasi nomor uji Anda.