Wapix MCP

Error codes

TENANT_REQUIRED

Grant çözülemedi; kiracı bağlamı yok.

Geçerli bir McpAccessGrant jetonu kullanın. Client tenantId yetki vermez.

TENANT_NOT_FOUND

Grant’teki kiracı bulunamadı.

Admin’de grant’i kontrol edin; kiracı silinmiş olabilir.

SESSION_NOT_FOUND

İstenen Cloud oturumu yok.

wapix_whatsapp_sessions ile izinli oturumları listeleyin.

SESSION_TENANT_MISMATCH

Oturum bu grant’in kiracısına ait değil.

Başka kiracının sessionId’sini kullanmayın. Cross-tenant yok.

SESSION_NOT_ALLOWED

Oturum grant allowlist dışında.

Grant’e oturumu ekleyin veya tüm Cloud oturumlarını açın.

SESSION_CONTEXT_CONFLICT

Birden fazla izinli oturum var; sessiz seçim yok.

Tool çağrısında sessionId verin.

NOT_CLOUD_SESSION

Oturum WhatsApp Cloud değil.

Yalnız Cloud oturumları MCP kapsamındadır.

GRAPH_AUTH_FAILED

Meta Graph kimliği geçersiz veya süresi dolmuş.

Panelden Cloud kimlik bilgilerini yenileyin. Token MCP’de görünmez.

GRAPH_PERMISSION_DENIED

Meta uygulamasının bu Graph işlemi için izni yok.

WABA / uygulama izinlerini Meta’da kontrol edin.

GRAPH_RATE_LIMITED

Meta hız sınırı.

Bir süre bekleyip tekrar deneyin.

GRAPH_REQUEST_FAILED

Graph isteği başarısız.

Oturum sağlığını kontrol edin; ayrıntı logdadır, client’a sızmaz.

CAPABILITY_NOT_SUPPORTED

Bu yetenek Wapix Graph katmanında yok.

configure_webhooks desteklenmez. WABA aboneliği için wapix_whatsapp_subscribe_webhook kullanın.

MCP_ACCESS_DENIED

Jeton geçersiz veya Authorization eksik.

Authorization: Bearer wpx_mcp_… kullanın. Query token kabul edilmez.

MCP_ACCESS_REVOKED

Grant iptal edilmiş.

Admin → MCP Erişimi’nden yeni grant oluşturun.

MCP_ACCESS_EXPIRED

Grant süresi dolmuş.

Yeni grant oluşturun veya süreyi uzatın.

MCP_PERMISSION_DENIED

Grant’te bu tool için izin yok.

Preset veya izin listesini tool’un permission alanına göre güncelleyin.

MCP_WRITE_DISABLED

Yazma tool’ları bu ortamda kapalı.

Grant izni yetmez; ortam yazma kilidi de açık olmalıdır. İzin yükseltmesi env ile olmaz.

MCP_DESTRUCTIVE_DISABLED

Yıkıcı işlemler kapalı.

whatsapp:destructive + ortam destructive kilidi gerekir. FULL preset otomatik açmaz.

MCP_RATE_LIMITED

Grant hız sınırı aşıldı.

Bir dakika bekleyip tekrar deneyin.

TEMPLATE_NOT_FOUND

Şablon bulunamadı.

templateId veya name + language ile list_templates / get_template kullanın.

TEMPLATE_KIND_NOT_SUPPORTED

Bu şablon türü Wapix tarafından desteklenmiyor.

Yalnız desteklenen kind / wizard ile oluşturun veya güncelleyin.

MESSAGE_SEND_FAILED

Mesaj gönderilemedi (plan limiti veya gönderim hatası).

Plan kotasını ve alıcıyı kontrol edin. Token dönmez.

VALIDATION_ERROR

Tool girişi geçersiz.

Zorunlu alanları (to, type, templateId vb.) tool referansına göre doldurun.