Bilder und Dateien in Apple Messages senden
Verwenden Sie ein Image- oder Document-Template, um Produktbilder, Anleitungen oder eine Quittung in einer offenen Kundenkonversation zu senden. Bird ruft die Quelldatei ab und bereitet sie während der Nachrichtenverarbeitung für Apple auf.
Eine abrufbare Datei vorbereiten
Hosten Sie die gewünschte Datei unter einer öffentlichen HTTPS-URL, die ohne Browser-Cookies oder Anmeldung abgerufen werden kann. Verwenden Sie eine zweckgebundene Datei, die unter dieser URL bedenkenlos zugänglich ist. Eine Vorschauseite eines privaten Laufwerks ist keine direkte Datei-URL.
Die Send-Message-Referenz definiert die Medienanforderungen:
| Verwendung | Anforderung |
|---|---|
| Ausgehender Anhang | Jede Datei ist kleiner als 100 MB. Geben Sie den korrekten Dateinamen und Medientyp an. |
| Native Interaktion oder Rich-Link-Bild | PNG, bis zu 200 kB pro Bild; interaktive Bilder insgesamt maximal 5 MB. |
| Veröffentlichtes iMessage-App-Icon | PNG kleiner als 15 kB. Siehe App Experiences. |
Halten Sie die URL verfügbar, bis die Verarbeitung abgeschlossen ist. Eine signierte URL, die zu früh abläuft, kann einen Fehler verursachen, nachdem die Nachricht bereits akzeptiert wurde. Testen Sie die URL ohne angemeldeten Browser und prüfen Sie, ob sie die eigentliche Datei zurückgibt und nicht eine HTML-Seite.
Vorlage konfigurieren
- Öffnen Sie Templates und wählen Sie New template > Image oder Document.
- Geben Sie unter Content dem Entwurf einen Template name und tragen Sie eine hilfreiche Message ein, die den Anhang erklärt.
- Setzen Sie unter Apple delivery die Felder Attachment URL, File name und Media type. Für ein PDF verwenden Sie beispielsweise einen .pdf-Dateinamen und application/pdf.
- Wählen Sie das Unternehmen unter Personalization aus und speichern Sie den Entwurf.
- Bereiten Sie die Nachricht vor und prüfen Sie sie, indem Sie den tatsächlichen Kunden und die Datei vor dem Senden kontrollieren.
Mitgelieferte Vorschaugrafiken sind keine Anhangquelle für einen echten Versand. Geben Sie Ihre gewünschte URL explizit an.
Ergebnis prüfen
Prüfen Sie die gesendete Nachricht und die Ereignisse und öffnen Sie den Anhang auf einem autorisierten Apple-Testgerät. Achten Sie auf Lesbarkeit, den Dateinamen und darauf, ob der Inhalt ohne die umgebende Website verständlich ist.
Falls die Nachricht nach der Annahme fehlschlägt, prüfen Sie den Fehler, bevor Sie das Template ändern. Häufige Ursachen sind eine nicht erreichbare URL, ein unerwarteter Medientyp, eine Datei über dem Größenlimit oder ungültige PNG-Daten. Das Ändern einer Dateiendung konvertiert nicht das Format.
Eingehende Anhänge können im Gesprächsprotokoll namentlich erscheinen. Das Protokoll bietet derzeit keine authentifizierte Download-Aktion für diese Dateien. Die Anhangs- und Medienabrufoperationen sind nicht Teil der öffentlichen API. Falls Ihr Dienst das Herunterladen eingehender Dateien erfordert, bestätigen Sie einen verfügbaren Abruf-Workflow mit Bird, bevor Sie sich darauf verlassen.