İçeriğe geç
OmniChannels.ai

Yapay zekâ asistanları ve ajanları

Claude Code + OmniChannels.ai: mesajlaşmayı terminalinizden geliştirin ve test edin

MCP ile bağlanınAPI ve webhook'larla bağlanınGüncelleme

Kısaca

Claude Code, OmniChannels.ai'ye tek komutla bağlanır: https://mcp.broadnet.me/mcp adresini gösteren ve Authorization: Bearer başlığı taşıyan claude mcp add --transport http. Ardından entegrasyon kodunuzu OpenAPI 3.1 şemamızdan yazarken test mesajı gönderebilir, WhatsApp şablonlarını listeleyebilir ve iletim raporlarını okuyabilir. Ekipler sunucuyu .mcp.json ile paylaşır; izin kuralları hangi araçların onaysız çalışacağını belirler.

Neler yapabilirsiniz?

  • Gerçek şablonlardan kod yazın

    Claude Code, onaylı WhatsApp şablonlarınızı MCP ile okur ve her birinin tam olarak ihtiyaç duyduğu değişkenlerle bir fonksiyon yazar.

    Şunu sormayı deneyin

    “omnichannels araçlarını kullanarak onaylı WhatsApp şablonlarımı listele, ardından order_update şablonunu gereken alanlarla gönderen bir TypeScript fonksiyonu yaz.”

  • Webhook işleyicisi geliştirin

    Claude Code'u webhook rehberine yönlendirin; iletim durumlarını ve gelen mesajları kaydeden, kanallara göre değişen alanlara toleranslı bir uç nokta yazar.

    Şunu sormayı deneyin

    “SUBMITTED, SENT, DELIVERED, READ, FAILED ve REJECTED durumlarını mesaj kimliğine göre kaydeden, bilinmeyen alanları hata vermek yerine günlüğe yazan bir Express webhook işleyicisi yaz.”

  • Şemadan tipli istemci üretin

    OpenAPI şeması deponuzda kayıtlıysa Claude Code yolları ve alanları tahmin etmek yerine tam olarak onları kullanır.

    Şunu sormayı deneyin

    “docs/omnichannels-openapi.yaml dosyasını kullanarak POST /sms/sendSms ile SMS gönderen bir Python modülü yaz ve kullandığın her alanı şemadaki tipiyle listele.”

  • Kendi numaranızda uçtan uca test edin

    Claude Code, araç çağrısını onayladıktan sonra bir test mesajı gönderir, ardından kod yolunuzun çalıştığını iletim raporundan doğrular.

    Şunu sormayı deneyin

    “OmniDemo adından 447700900123 numaralı telefonuma bir test SMS'i gönder, ardından iletim raporunu kontrol et.”

  • Başarısız gönderimleri ayıklayın

    Okuma araçları, Claude Code'un iletim raporlarını günlüklerinizle karşılaştırmasına ve bir hatayı onu doğuran isteğe kadar izlemesine olanak tanır.

    Şunu sormayı deneyin

    “Dünkü kampanyanın iletim raporunu oku, hata nedenlerini özetle ve yeniden deneme kodumuzu hatalar rehberiyle karşılaştır.”

Nasıl bağlanır?

MCP ile bağlanınAPI ve webhook'larla bağlanın

Claude Code, uzak MCP sunucularını claude mcp add --transport http komutu ve bir Authorization başlığıyla ekler. Komutu çalıştırdığınızda kabuğunuz jetonu bir ortam değişkeninden açar; ekipler için proje kapsamlı bir .mcp.json, her geliştiricinin kendi jetonunu ${BROADNET_TOKEN} aracılığıyla vermesini sağlar ve Claude Code kullanmadan önce her kişiden sunucuyu onaylamasını ister.

MCP, hesabınız üzerinde işlem yapmayı kapsar: test mesajı göndermek, şablonları ve iletim raporlarını okumak. Entegrasyon kodu yazmak için Claude Code'a uç noktalar ve alanlar konusunda tek doğru kaynak olarak OpenAPI 3.1 şemamızı, ayrıca webhook yükleri şemada olmadığı için webhook rehberini verin. mcp__omnichannels__get_* gibi izin kuralları okuma araçlarını onaysız çalıştırırken gönderim araçlarının yine sormasını sağlar.

  • Komut: claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp
  • Ekip kurulumu: anahtar değil, Bearer ${BROADNET_TOKEN} içeren .mcp.json'u commit edin
  • İzin kuralları araçları mcp__omnichannels__<tool> olarak adlandırır
  • Tam istek alanları için /developers/openapi.json adresindeki OpenAPI 3.1 şeması
  • Tekil SMS JSON'dur; toplu ve diğer kanalların çoğu multipart/form-data kullanır

Kurulum

  1. 1

    API erişimi talep edin

    Test erişimi talep edin ve bir API jetonu alın. Test gönderimleri yalnızca doğrulanmış kendi numaralarınıza gider.

  2. 2

    Geçici anahtar alın

    Yönetim portalında Integrations, ardından MCP Integration bölümünü açın, Get temporary key'i seçin ve BROADNET_TOKEN olarak dışa aktarın.

    Rehber: MCP server for AI agents
  3. 3

    Sunucuyu ekleyin

    Authorization başlığıyla claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp komutunu çalıştırın veya ekibiniz için bir proje .mcp.json'u commit edin, ardından /mcp ile kontrol edin.

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

    İzin kurallarını belirleyin

    İsterseniz mcp__omnichannels__get_* gibi okuma araçlarına izin verin, her gönderim aracını soru modunda tutun ve projenin ihtiyaç duymadığı araçları reddedin.

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

    OpenAPI şemasını ekleyin

    openapi.yaml dosyasını deponuza indirin ve Claude Code'a uç nokta yolları, alanlar ve enum değerleri için onu kullanmasını söyleyin.

    Rehber: OpenAPI 3.1 spec
  6. 6

    Kendi numaranızda test edin

    Claude Code'dan doğrulanmış numaranıza test mesajı göndermesini isteyin, ardından iletim raporunu okutun.

Üretici belgeleri

Claude Code, sahibinin ticari markasıdır. OmniChannels.ai, Claude Code ile bağlantılı değildir ve Claude Code tarafından onaylanmamıştır; bu sayfa, Claude Code'in kendi MCP, HTTP veya webhook özellikleriyle kurulan bir bağlantıyı açıklar.

Örnek iş akışı

Tipik bir isteğin Claude Code üzerinden müşterinize ve geri nasıl ilerlediği.

  1. 01

    Claude Code

    Entegrasyonunuzu yazar, istendiğinde araçları çağırır

  2. 02

    OmniChannels.ai MCP ve API

    Testler için MCP araçları; kodunuz REST API'yi çağırır

  3. 03

    Test telefonunuz

    Doğrulanmış numaranıza test SMS veya WhatsApp

  4. 04

    Webhook işleyiciniz

    İletim durumlarını ve gelen mesajları alır

1. Claude Code: Entegrasyonunuzu yazar, istendiğinde araçları çağırır 2. OmniChannels.ai MCP ve API: Testler için MCP araçları; kodunuz REST API'yi çağırır 3. Test telefonunuz: Doğrulanmış numaranıza test SMS veya WhatsApp 4. Webhook işleyiciniz: İletim durumlarını ve gelen mesajları alır

Sorular

Claude Code için resmi bir OmniChannels.ai eklentisi var mı?

Hayır. Claude Code, uzak MCP sunucuları için standart desteği üzerinden herkese açık uç noktamız ve API jetonunuzla bağlanır; herkese açık OpenAPI şemamızı da deponuzdaki başka bir dosya gibi okur.

Anahtar paylaşmadan sunucuyu ekibimle nasıl paylaşırım?

Authorization başlığı ${BROADNET_TOKEN} kullanan, proje kapsamlı bir .mcp.json commit edin. Her geliştirici bu değişkeni kendi kabuğunda tanımlar ve Claude Code, proje sunucusunu kullanmadan önce onlardan onay ister.

Claude Code sormadan mesaj gönderebilir mi?

Varsayılan olarak Claude Code bir MCP aracını kullanmadan önce sorar. Her gönderim gerçek ve ücretlendirilen bir mesaj olduğundan gönderim araçlarında bunu koruyun. İzin kurallarınızda yalnızca okuma araçlarına izin verin; araç adları sunucu sürümüne ve hesabınıza bağlı olduğundan önce /mcp altında kontrol edin.

Ürünümde MCP mi yoksa REST API mi kullanmalıyım?

Geliştirme sırasında Claude Code'un hesabınızı test edip incelemesi için MCP kullanın. Yayına verdiğiniz kod, gizli bilgi deponuzdan alınan bir jetonla doğrudan REST API'yi çağırmalı ve tam alanlar için OpenAPI şemasını kullanmalıdır.

API ve MCP erişimi alın

Kanallarınızı, ülkelerinizi ve kullanım senaryonuzu bize söyleyin. Bir mühendis test kimlik bilgilerini verir ve test numaralarınızı doğrular.