Przejdź do treści

Połącz Zapier za pomocą osobistego klucza API

Aplikacja Marcomm AI dla Zapiera uruchamia Zapy na podstawie komunikatów prasowych, wpisów na blogu i wydarzeń prasowych oraz je tworzy, publikuje i wysyła. Działa na zaproszenie.

  1. 1
    W Marcomm przejdź do Ustawienia → Integracje → Zapier, aby zobaczyć stan i potrzebne wartości.
    Ustawienia, Integracje, Zapier, ze stanem, krokami połączenia, zakresami do zaznaczenia i stanem dostępu do API
    Strona Zapier pokazuje bieżący stan, kroki, wartości do skopiowania oraz to, czy dostęp do API jest zatwierdzony dla tej przestrzeni roboczej.
  2. 2
    Otwórz Ustawienia → API. Jeśli przestrzeń robocza nie ma jeszcze dostępu do API, właściciel lub administrator wypełnia Złóż wniosek o dostęp do API i wybiera Wyślij wniosek.
  3. 3
    Po zatwierdzeniu otwórz Utwórz klucz, wybierz Klucz osobisty, zaznacz potrzebne Uprawnienia i wybierz Utwórz klucz. Od razu skopiuj klucz, bo jest pokazywany tylko raz.
  4. 4
    Otwórz link z zaproszeniem od Marcomm AI i dodaj aplikację Marcomm AI do swojego konta Zapier.
  5. 5
    Utwórz Zap, wybierz Marcomm AI jako wyzwalacz lub akcję i wklej klucz w polu API Key (klucz API), gdy Zapier poprosi o połączenie.

Najpierw wypróbuj kroki publikowania i wysyłki na wersji roboczej, bo nie można ich cofnąć.

Aplikacji nie ma jeszcze w publicznym katalogu Zapiera, więc potrzebujesz linku z zaproszeniem od Marcomm AI. Ma siedem wyzwalaczy: New Press Release, Press Release Approval Requested, Press Release Published, New Blog Post, Blog Post Published, New Press Event i RSVP Invite Updated. Jej akcje tworzą, aktualizują, kierują do zatwierdzenia, publikują i wysyłają komunikaty prasowe, tworzą i publikują wpisy na blogu, tworzą wydarzenia prasowe oraz tworzą, uzupełniają i wysyłają zaproszenia RSVP. Dwa wyszukiwania znajdują komunikat prasowy lub wpis na blogu.

Uprawnienia określają, co może klucz. Treści (content) odczytuje komunikaty prasowe, wpisy na blogu i wydarzenia prasowe, Pisanie treści (content:write) tworzy i edytuje wersje robocze, Publikowanie i wysyłka (distribution) publikuje i wysyła e-mailem, a Zatwierdzenia (approvals) obejmuje kroki zatwierdzania. Trzy ostatnie działają tylko z typem Klucz osobisty, bo działanie jest zapisywane na osobę, która utworzyła klucz. Klucz przestrzeni roboczej może tylko odczytywać, a każdy klucz działa z rolą i uprawnieniami swojego twórcy.

Publikowania i wysyłki nie można cofnąć. API wykonuje je tylko wtedy, gdy żądanie zawiera confirm: true lub nagłówek Idempotency-Key, i nic nie publikuje, odpowiadając 409, dopóki potrzebne jest zatwierdzenie albo treść jest zaplanowana lub objęta embargiem. Ponowienie z tym samym Idempotency-Key i tym samym żądaniem przez 24 godziny zwraca pierwszy wynik zamiast wykonywać je jeszcze raz. Każdy krok zapisu wysyła klucz idempotencji utworzony z Zapa i jego danych wejściowych. Jeśli Zap ma celowo powtórzyć dokładnie ten sam krok w ciągu 24 godzin, wpisz w Repeat Key wartość, która zmienia się przy każdym uruchomieniu.

API jest dostępne od planu Team wzwyż. Zespół Marcomm AI sprawdza każdy wniosek, a klucze działają dopiero po zatwierdzeniu. Klucz może używać tylko uprawnień zatwierdzonych dla przestrzeni roboczej, a każda osoba może mieć do 10 kluczy. Domyślnie przestrzeń robocza może wysłać 60 żądań na minutę i 10 000 na dzień; powyżej API odpowiada 429 z nagłówkiem Retry-After. Aby podnieść limity, użyj Potrzebujesz wyższych limitów? w Ustawienia → API. Aby odłączyć Zapier, wybierz Unieważnij obok klucza; systemy, które go używają, od razu tracą dostęp.

Najczęstsze pytania

Wywołaj GET https://marcomm.works/api/v1/me z nagłówkiem Authorization: Bearer i swoim kluczem. Działa to z każdym zatwierdzonym kluczem bez względu na jego uprawnienia i zwraca przestrzeń roboczą, nazwę klucza oraz jego uprawnienia.

Klucz nie zapisuje, która usługa go używa, więc Marcomm nie oznacza karty Zapier jako połączonej. W Ustawienia → API widać, kiedy każdy klucz był ostatnio użyty.

Nie. Aplikacja Zapier może poprosić o zatwierdzenie, a decyzję podejmuje zatwierdzający w Marcomm. Przez API zatwierdzać lub odrzucać może osobisty klucz z uprawnieniem Zatwierdzenia.

Integracje