Skip to main content
POST
Senden Sie eine neue Direktnachricht an einen Empfänger.
Preise & Limits: Jedes User Profile kann bis zu 1.000 aktive Konversationen pro Abrechnungszeitraum über alle sozialen Netzwerke hinweg haben. Die Preise hängen von Ihrem Plan ab: Premium-Plans zahlen ein pauschales $49 pro Monat-Add-on, während Launch- und Business-Plans mit $0,09 pro aktiver Konversation abgerechnet werden. Eine Konversation wird als aktiv gezählt, wenn Sie während des Abrechnungszeitraums eine Nachricht an einen Empfänger senden; eingehende Nachrichten allein zählen nicht. Die Anzahl der Nachrichten innerhalb einer aktiven Konversation ist unbegrenzt.
  • Sie können ein Emoji als Teil des message-Textes senden.
  • mediaUrls für Facebook und Instagram müssen mit einer bekannten Dateierweiterung enden. Das Hinzufügen von Query-Parametern führt dazu, dass die Medien-URL fehlschlägt.
WhatsApp-24-Stunden-Kundenservice-Fenster. WhatsApp Business erlaubt Freiform-Nachrichten nach außen nur innerhalb von 24 Stunden nach der letzten Nachricht des Korrespondenten. Nach diesem Fenster werden Nachrichtenversände von Meta abgelehnt, bis der Korrespondent erneut eine Nachricht sendet. Templated Messages außerhalb des 24-Stunden-Fensters werden über diesen Endpunkt derzeit nicht unterstützt.

Header-Parameter

Pfad-Parameter

string
erforderlich
Die Plattform, an die die Nachricht gesendet werden soll: facebook, instagram, twitter, whatsapp

Body-Parameter

string
erforderlich
Die ID des Nachrichtenempfängers.
  • Für Facebook, Instagram und X/Twitter ist dies die plattformspezifische Nutzer-ID (PSID, IGSID oder User-ID).
  • Für WhatsApp ist dies die Telefonnummer des Empfängers im E.164-Format nur mit Ziffern (zum Beispiel 14155551234, nicht +1 (415) 555-1234).
string
erforderlich
Die an den Empfänger zu sendende Nachricht.
  • Bei Facebook, Instagram und WhatsApp kann message ein leerer String sein oder ganz weggelassen werden, wenn mediaUrls angegeben ist.
  • X erfordert eine Nachricht mit mindestens einem Zeichen, auch wenn mediaUrls angegeben ist.
array
Array von Medien-URLs zum Anhängen von Bildern, Videos, Audio (einschließlich Sprachnachrichten) oder Dokumenten.
  • URLs von Medienelementen sollten mit der Dateierweiterung ohne zusätzlich angehängte Parameter enden.
  • Facebook und Instagram unterstützen mehrere Medien-URLs.
  • X akzeptiert nur eine einzige Medien-URL.
  • Sprachnachrichten werden auf Facebook und Instagram als aac- oder wav-Datei unterstützt.
  • WhatsApp akzeptiert mehrere Medien-URLs. Ayrshare ruft jede URL ab und verwendet den Response-Content-Type, um die WhatsApp-Medienkategorie zu bestimmen. Meta akzeptiert:
    • Bild: .jpg, .jpeg, .png
    • Video: .mp4, .3gp
    • Audio: .aac, .amr, .mp3, .m4a, .ogg
    • Dokument: .txt, .pdf, .ppt, .pptx, .doc, .docx, .xls, .xlsx