Zum Hauptinhalt springen

Über die API eines Posting-Dienstes posten

Zeitgesteuert auf mehreren Konten und mehreren Plattformen zu posten, ist eine Aufgabe, die Posting-Dienste bereits gut erledigen, und die meisten bieten dafür eine API. Diese Anleitung sendet jede Übergabe von Ihrem Webhook direkt an diese API, sodass jeder Beitrag den Dienst ohne jemanden dazwischen erreicht: Ihr eigenes Skript oder eine Automatisierungsplattform wie Make, n8n oder Zapier sitzt in der Mitte.

Um Beiträge stattdessen manuell aus der E-Mail in einen Dienst zu übertragen, siehe Über einen Posting-Dienst posten.

Empfangen, die Signatur prüfen, antworten und zurückmelden sind für jeden Empfänger gleich und stehen unter Per Webhook übergeben. Diese Seite beschreibt, was nach der Antwort kommt.

Welcher Dienst​

Was ein Posting-Dienst ist, und die Dienste mit ihren Stärken und dem, worauf zu achten ist, einschließlich des Verzichts auf einen, werden in Über einen Posting-Dienst posten verglichen. Reelwire ist mit keinem von ihnen verbunden und funktioniert mit jedem, dessen API ein Video aus einem Link oder einer Datei posten kann. Prüfen Sie für diese Anleitung auf der Website des Dienstes, dass seine API Video auf jeder Plattform postet, die Sie brauchen, in den Bildformaten, die Ihre Kanäle verwenden (ein 9x16-Reel ist kein 1x1-Feed-Beitrag), und was sein Tarif für Ihr Volumen kostet.

Schritt für Schritt​

Ein Workflow in sieben Schritten: Der Webhook antwortet sofort, die Signatur wird geprüft, der Aufruf wird nach Ereignis sortiert und pro Kanal aufgeteilt, jeder Kanal wird über den Dienst gepostet, und der Beitrag wird an Reelwire zurückgemeldet

  1. Richten Sie Reelwire auf Ihren Empfänger aus. Erstellen Sie in einem Automatisierungswerkzeug einen Webhook-Trigger und kopieren Sie seine Adresse; bei einem Skript verwenden Sie die Adresse, auf der es lauscht. Fügen Sie sie auf der Seite Webhook in Reelwire (unter Verbindungen) in Webhook-Adresse ein und klicken Sie auf Speichern; die Karte Code abrufen dort enthält einen funktionierenden Empfänger, um ein Skript zu beginnen. Klicken Sie auf Zustellung testen: Der Empfänger sollte eine Anfrage mit "event": "ping" zeigen.

  2. Schalten Sie Per Webhook übergeben ein für die Kanäle, deren Beiträge diesen Weg gehen sollen, in den Einstellungen jedes Kanals unter Kanäle. Von da an kommt jeder für sie fällige Beitrag als eine Anfrage an: Was sie genau enthält, steht unter Webhooks.

  3. Prüfen Sie, dass sie von Reelwire kam. Jede Anfrage ist mit dem Signatur-Secret des Workspaces signiert, wie unter Per Webhook übergeben beschrieben; die meisten Automatisierungswerkzeuge können auch einen HMAC berechnen. Akzeptieren Sie mindestens nur Anfragen, deren x-reelwire-event eines ist, das Sie erwarten, und handeln Sie nie zweimal bei derselben x-reelwire-delivery-ID.

  4. Geben Sie jeden Kanal an den Dienst. Eine Übergabe enthält eine Liste von channels, einen pro Kanal des Beitrags, der per Webhook geht. Nehmen Sie für jeden die Adresse des Videos (den Eintrag in channels[].media, dessen kind video ist, ein Link, der sieben Tage funktioniert), seinen Text (channels[].text: die Bildunterschrift, die Beschreibung der Marke als disclaimer, Hashtags, Titel und Link, wie die Plattform sie aufnimmt; bei einem Kanal auf Keine bestimmte Plattform die Länge in captions, die dazu passt, wo der Dienst postet), seine Veröffentlichungseinstellungen (channels[].posting, wo der Dienst sie festlegen kann) und die ID des Kanals und rufen Sie die API des Dienstes auf, um einen Beitrag für das Konto zu erstellen, dem Sie diesen Kanal zuordnen. Die meisten Dienste nehmen ein Video per Link; will Ihrer die Datei selbst, laden Sie sie zuerst herunter und prüfen ihr sha256.

  5. Sagen Sie, dass er online ist. Wenn der Dienst den Beitrag bestätigt, melden Sie ihn für diesen Kanal, mit einem API-Schlüssel, erstellt auf der Seite API-Schlüssel, der Schreibrecht für Beiträge hat:

    POST https://app.reelwire.io/v1/posts/{postId}/report
    Authorization: Bearer rw_...
    Content-Type: application/json

    { "status": "published", "url": "https://www.instagram.com/reel/..." }

    postId ist channels[].postId aus der Übergabe. Konnte der Dienst ihn nicht posten, melden Sie "failed" mit einem "reason": Beiträge zeigt dann den Grund, und jemand kann ihn manuell posten. Ein Dienst, der den Beitrag für später plant, sagt Ihnen es möglicherweise erst, wenn er veröffentlicht ist, über seinen eigenen Webhook: Melden Sie dann.

Beantworten Sie die Anfrage von Reelwire schnell, mit einem beliebigen 2xx, und rufen Sie den Dienst danach auf: Eine Antwort, die länger als 30 Sekunden dauert, zählt als Fehler, und Reelwire sendet sie erneut. Die Antwort sagt nur, dass die Anfrage angekommen ist; die Veröffentlichung ist das, was die Meldung sagt.

Änderungen und Entfernungen​

Änderungen folgen demselben Weg. Wenn jemand einen Beitrag in Reelwire mit Aktualisierungsanfrage senden unter Beiträge aktualisiert, erhält der Empfänger ein post.update mit dem neuen Text (und einem neuen Video, wo es ersetzt wurde); wenn jemand eine Löschanfrage sendet, ein post.delete. Geben Sie sie an den Dienst weiter, wo seine API bearbeiten oder löschen kann, oder machen Sie daraus eine Aufgabe für eine Person, wo nicht, und melden Sie "deleted", sobald ein Beitrag weg ist.

Wenn etwas nicht ankommt​

Versendeter Inhalt auf der Seite Aktivität listet jede Anfrage auf, die Reelwire gesendet hat, was der Empfänger geantwortet hat, und Details mit allem, was sie trug. Eine abgelehnte Anfrage wird nach 10 Sekunden, einer Minute, fünf Minuten, einer Viertelstunde, einer Stunde und zwei Stunden erneut versucht, dann aufgegeben; Erneut zustellen sendet sie noch einmal.