Zum Seiteninhalt springen
Docs
Make Agent Fast Dokumentation

Broadcasts

Stellen Sie Kakao-AlimTalk-Vorlagennachrichten für berechtigte erfasste Leads mit ausdrücklicher Einwilligung und Provider-Bereitschaft in die Warteschlange.

Auf einen Blick

Stellen Sie Kakao-AlimTalk-Vorlagennachrichten für berechtigte erfasste Leads mit ausdrücklicher Einwilligung und Provider-Bereitschaft in die Warteschlange.

API-AnfragepfadSchlüssel mit Bereich → versionierte Ressource → signierte Antwort
App / SDKBearer-Schlüsselmaf_live_…/api/v1/…RessourceJSON
EmpfängerVorlageWarteschlange
Video-Tutorial · Folge 7Leads & Vertriebspipeline2:26 – 3:09 · Englischer TonGanze Folge und Kapitel →

Aktuellen Funktionsumfang kennen#

Die Broadcast-Funktion im Dashboard ist derzeit auf Kakao AlimTalk ausgerichtet. Sie ist kein allgemeiner Kampagnen-Composer für Telegram, WhatsApp, Messenger oder Discord. Ein aktives AlimTalk-Gateway erfordert ein registriertes Absenderprofil, eine genehmigte Vorlage, einen konfigurierten Plattform-Provider und für jeden Empfänger eine erreichbare koreanische Telefonnummer.

Die Anzahl der Empfänger wird aus nicht gelöschten Leads der aktuellen Website mit einem erreichbaren Kontaktwert ermittelt und nach Kontakt dedupliziert. Im Entwicklungs- bzw. Mock-Modus wird möglicherweise eine E-Mail-Adresse als Ersatz akzeptiert, ein echtes AlimTalk-Gateway benötigt jedoch eine passende Telefonnummer. Prüfen Sie, ob der angezeigte Modus „live“ ist, bevor Sie eine eingereihte Nachricht als echte Zustellung betrachten.

Die Grenze beim Versand verstehen#

Wenn Sie auf Senden klicken, wird für jeden aktuell berechtigten Empfänger ein dauerhafter Job in die Warteschlange gestellt. Das Dashboard bietet derzeit keine Segmentierung pro Versand, keine Bearbeitung der Empfänger, keinen geplanten Versandzeitpunkt, keine Vorschau der Zielgruppe sowie keine Möglichkeit zum Pausieren oder Zurückrufen. Verwenden Sie die Schaltfläche erst, wenn die gesamte ermittelte Zielgruppe die Nachricht erhalten soll und dazu berechtigt ist.

Das Formular akzeptiert einen genehmigten Vorlagencode und einen Nachrichtentext mit bis zu 2.000 Zeichen. Ein Provider kann eine kürzere Vorlage, den exakten genehmigten Wortlaut bzw. die genehmigten Variablen sowie Vorgaben zu Zeitpunkt, Absenderprofil und Richtlinien durchsetzen. Das Einreihen in die Warteschlange durch Make Agent Fast setzt diese Regeln nicht außer Kraft.

Einen rechtskonformen Broadcast vorbereiten#

  1. Vergewissern Sie sich, dass beim Lead-Erfassungsprozess der Website der relevante Kontakt sowie die Einwilligung bzw. Rechtsgrundlage abgefragt wurden.
  2. Entfernen oder löschen Sie Personen, die nicht kontaktiert werden sollen, bevor die Zielgruppe ermittelt wird.
  3. Prüfen Sie, dass ein aktiver AlimTalk-Provider und ein registrierter Sender Key konfiguriert sind.
  4. Holen Sie den vom Provider genehmigten Vorlagencode ein und stimmen Sie den Nachrichtentext auf diese Vorlage ab.
  5. Prüfen Sie Absenderidentität, Zweck, Links, erforderliche Pflichtangaben und die Möglichkeit zur Abmeldung.
  6. Verwenden Sie eine separate Test-Website bzw. Testzielgruppe, wenn Sie einen kleinen Produktivtest benötigen; der aktuelle Composer richtet sich an alle berechtigten Leads seiner Website.

Senden Sie keine Zugangsdaten, sensiblen Kontodetails, geschützten Datensätze, erfundenen Personalisierungen oder Angebote, die der Agent bzw. die Website nicht freigegeben hat.

In die Warteschlange stellen und beobachten#

Nach dem Versand zeigt der Verlauf den Nachrichtentext, den Status, die vorgesehene Empfängeranzahl und die Anzahl erfolgreicher Sendungen. Jobs sind pro Broadcast und Lead idempotent, sodass ein erneuter Versuch der Warteschlange nicht absichtlich eine zweite Kopie desselben Broadcast-Empfänger-Paares erzeugen sollte.

„Gesendet“ bedeutet, dass das konfigurierte Gateway alle nachverfolgten Sendungen akzeptiert hat. Es belegt weder die Zustellung auf dem Telefon noch das Lesen, eine Conversion oder eine gültige Marketing-Einwilligung. Nutzen Sie, sofern verfügbar, die Zustellbestätigungen des Gateways und Ihr Business-Reporting.

Wenn einzelne Jobs fehlschlagen, behält der Broadcast den letzten Provider-Fehler bei, während erfolgreiche Sendungen unabhängig davon hochgezählt werden. Erstellen Sie keinen neuen identischen Broadcast, bevor Sie geklärt haben, ob der Provider frühere Versuche bereits akzeptiert hat.

API-Automatisierung#

Verwenden Sie broadcasts:write, um über die Public API von einem vertrauenswürdigen Server aus einen Entwurf zu erstellen und in die Warteschlange zu stellen. Bewahren Sie die Idempotenz und prüfen Sie die Ermittlung der Empfänger sowie die Provider-Bereitschaft. Die API kann eine nicht genehmigte AlimTalk-Vorlage nicht konform machen.

Fehlerbehebung#

SymptomPrüfen
Die Schaltfläche „Senden“ ist deaktiviertKeine berechtigten Leads der Website mit erreichbarem Kontakt vorhanden
Der Modus zeigt lokal/Dev anDer aktive AlimTalk-Provider bzw. die Zugangsdaten sind nicht konfiguriert; keine echte Zustellung an Customers
Das Gateway lehnt die Vorlage abGenehmigter Vorlagencode, Nachrichtentext/Variablen, Absenderprofil und Empfängerformat
Die Empfängeranzahl enthält unbrauchbare KontakteFür die echte Zustellung wird eine Telefonnummer benötigt; bereinigen Sie die Lead-Erfassung bzw. die Daten vor dem Versand
Der Verlauf bleibt bei „Wird gesendet“Fehler in Warteschlange/Provider sowie sent count im Vergleich zur Empfängeranzahl
Nur ein Segment soll kontaktiert werdenWird in diesem Composer derzeit nicht unterstützt; richten Sie einen genehmigten separaten Zielgruppen-Workflow ein, statt an alle zu senden

Stoppen Sie den Versand, sobald Beschwerden, unerwartete Empfänger, Abweichungen bei der Vorlage oder Provider-Fehler auftreten.