İçeriğe geç

Zapier’ı kişisel API anahtarıyla bağlayın

Zapier için Marcomm AI uygulamasıyla basın bültenleri, blog yazıları ve basın etkinliklerinden Zap başlatın; bunları oluşturun, yayımlayın ve gönderin. Uygulama davetle kullanılır.

  1. 1
    Marcomm’da Ayarlar → Entegrasyonlar → Zapier bölümüne giderek durumu ve gereken değerleri görün.
    Ayarlar, Entegrasyonlar, Zapier; durum, bağlantı adımları, işaretlenecek kapsamlar ve API erişim durumu görünüyor
    Zapier 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
    Marcomm AI’dan gelen davet bağlantısını açın ve Marcomm AI uygulamasını Zapier hesabınıza ekleyin.
  5. 5
    Bir Zap oluşturun, tetikleyici veya eylem olarak Marcomm AI’ı seçin ve Zapier bağlantı istediğinde anahtarı API Key (API anahtarı) alanına yapıştırın.

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

Uygulama henüz herkese açık Zapier dizininde değil, bu yüzden Marcomm AI’dan bir davet bağlantısı gerekir. Yedi tetikleyicisi vardır: New Press Release, Press Release Approval Requested, Press Release Published, New Blog Post, Blog Post Published, New Press Event ve RSVP Invite Updated. Eylemleri basın bültenlerini oluşturur, günceller, onaya gönderir, yayımlar ve gönderir; blog yazılarını oluşturup yayımlar; basın etkinlikleri oluşturur; RSVP davetlerini oluşturur, doldurur ve gönderir. İki arama bir basın bülteni veya blog yazısı bulur.

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. Her yazma adımı, Zap ve girdilerinden oluşturulan bir idempotency anahtarı gönderir. Bir Zap’in aynı adımı 24 saat içinde bilerek tekrarlaması gerekiyorsa Repeat Key alanına her çalıştırmada değişen bir değer girin.

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. Zapier 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 Zapier 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.

Hayır. Zapier uygulaması onay isteyebilir, kararı ise onaylayan kişi Marcomm’da verir. API üzerinden Onaylar kapsamına sahip kişisel bir anahtar onaylayabilir veya reddedebilir.

Entegrasyonlar