İçeriğe geç

Power Automate’i özel bağlayıcıyla bağlayın

Marcomm AI bağlayıcısını OpenAPI dosyasından Power Automate ortamınıza aktarın, ardından akışlarınızda kişisel API anahtarıyla Marcomm AI eylemlerini çalıştırın.

  1. 1
    Marcomm’da Ayarlar → Entegrasyonlar → Power Automate bölümüne giderek durumu ve gereken değerleri görün.
    Ayarlar, Entegrasyonlar, Power Automate; durum, bağlantı adımları, işaretlenecek kapsamlar ve API erişim durumu görünüyor
    Power Automate sayfası mevcut durumu, adımları, kopyalanacak değerleri ve bu çalışma alanı için API erişiminin onaylanıp onaylanmadığını gösterir.
  2. 2
    Ayarlar → API sayfasını açın. Çalışma alanının henüz API erişimi yoksa bir sahip veya yönetici API erişimi için başvurun formunu doldurup Başvuruyu gönder’i seçer.
  3. 3
    Onaydan sonra Anahtar oluştur bölümünü açın, Kişisel anahtar’ı seçin, gereken Kapsamlar’ı işaretleyin ve Anahtar oluştur’u seçin. Anahtar yalnızca bir kez gösterildiği için hemen kopyalayın.
  4. 4
    Power Automate’te Custom connectors’ı açın, New custom connector’ı, ardından Import an OpenAPI from URL’i seçin ve https://marcomm.works/api/v1/openapi.json girin.
  5. 5
    Security (Güvenlik) adımında API Key’i seçin, parametre adını Authorization, konumu Header (başlık) olarak ayarlayın ve bağlayıcıyı oluşturun.
  6. 6
    Bir akış bağlantı istediğinde Bearer, bir boşluk ve anahtarınızı girin.

Yayımlama ve gönderme adımları geri alınamadığı için önce bir taslakla deneyin.

Bağlayıcı Microsoft bağlayıcı listesinde yer almaz. Onu OpenAPI dosyasından kendi ortamınıza aktarırsınız, bu yüzden eylemleri API’yi izler: haberleri ve onayları okuma; basın bültenleri, blog yazıları, basın etkinlikleri ve RSVP davetleri oluşturma ve güncelleme; onay isteme, onaylama veya reddetme; yayımlama ve gönderme. Yalnızca eylemleri vardır, tetikleyicisi yoktur.

Kapsamlar bir anahtarın neler yapabileceğini belirler. İçerik (content) basın bültenlerini, blog yazılarını ve basın etkinliklerini okur, İçerik yazma (content:write) taslak oluşturur ve düzenler, Yayımlama ve gönderme (distribution) yayımlar ve e-postayla gönderir, Onaylar (approvals) ise onay adımlarını kapsar. Son üçü yalnızca Kişisel anahtar ile çalışır, çünkü işlem anahtarı oluşturan kişinin adına kaydedilir. Çalışma alanı anahtarı yalnızca okuyabilir ve her anahtar, oluşturan kişinin rolü ve yetkileriyle çalışır.

Yayımlama ve gönderme geri alınamaz. API bunları yalnızca istekte confirm: true veya Idempotency-Key başlığı varsa çalıştırır; onay hâlâ gerekiyorsa ya da içerik zamanlanmış veya ambargo altındaysa hiçbir şey yayımlamaz ve 409 döner. Aynı Idempotency-Key ve aynı istekle yapılan tekrar, yeniden çalışmak yerine 24 saat boyunca ilk sonucu döndürür. Bağlayıcıda bu eylemlerin bir confirm alanı ve bir Idempotency-Key alanı vardır.

API, Team planı ve üzerinde kullanılabilir. Marcomm AI ekibi her başvuruyu inceler ve anahtarlar yalnızca onaydan sonra çalışır. Bir anahtar yalnızca çalışma alanı için onaylanan kapsamları kullanabilir ve her kişi en fazla 10 anahtara sahip olabilir. Varsayılan olarak bir çalışma alanı dakikada 60, günde 10.000 istek yapabilir; bunun üzerinde API, Retry-After başlığıyla 429 döner. Sınırları yükseltmek için Ayarlar → API içindeki Daha yüksek sınırlara mı ihtiyacınız var? bölümünü kullanın. Power Automate bağlantısını kesmek için anahtarın yanındaki İptal et’i seçin; o anahtarı kullanan sistemler erişimi hemen kaybeder.

Sık sorulan sorular

Authorization: Bearer ve ardından anahtarınızı içeren başlıkla GET https://marcomm.works/api/v1/me çağırın. Kapsamları ne olursa olsun onaylanmış her anahtarla çalışır ve çalışma alanını, anahtarın adını ve kapsamlarını döndürür.

Anahtar hangi hizmetin onu kullandığını kaydetmez, bu yüzden Marcomm Power Automate kartını bağlı olarak işaretlemez. Her anahtarın en son ne zaman kullanıldığını Ayarlar → API sayfasında görürsünüz.

Bu bağlayıcıyla hayır, çünkü yalnızca eylemleri vardır. Akışı zamanlama gibi başka bir tetikleyiciyle başlatın ve en yeni öğeleri bir liste eylemiyle okuyun.

Entegrasyonlar