Envoyer des images et des fichiers dans Apple Messages
Utilisez un modèle Image ou Document pour envoyer des images de produits, des instructions ou un reçu dans une conversation client ouverte. Bird récupère le fichier source et le prépare pour Apple pendant le traitement du message.
Préparer un fichier accessible
Hébergez le fichier prévu à une URL HTTPS publique accessible sans cookies de navigateur ni connexion. Utilisez un fichier dédié qu'il est sûr d'exposer à cette URL. Une page d'aperçu de lecteur privé n'est pas une URL de fichier directe.
La référence d’envoi de messages définit les contraintes média :
| Utilisation | Exigence |
|---|---|
| Pièce jointe sortante | Chaque fichier fait moins de 100 Mo. Indiquez le nom de fichier et le type de média corrects. |
| Interaction native ou image rich-link | PNG, jusqu'à 200 ko par image ; les images interactives totalisent au maximum 5 Mo. |
| Icône d'app iMessage publiée | PNG inférieur à 15 ko. Voir expériences d’app. |
Gardez l'URL disponible pendant le traitement. Une URL signée qui expire trop tôt peut provoquer un échec après l'acceptation du message. Testez l'URL dans un navigateur sans session ouverte et confirmez qu'elle renvoie le fichier réel plutôt qu'une page HTML.
Configurer le modèle
- Ouvrez Templates et choisissez New template > Image ou Document.
- Dans Content, donnez un Template name au brouillon et saisissez un Message utile qui explique la pièce jointe.
- Dans Apple delivery, définissez Attachment URL, File name et Media type. Par exemple, un PDF utilise un nom de fichier .pdf et application/pdf.
- Sélectionnez l'entreprise dans Personalization, puis enregistrez le brouillon.
- Préparez et vérifiez le message, en contrôlant le client réel et le fichier avant l'envoi.
L'illustration d'aperçu intégrée n'est pas une source de pièce jointe pour un envoi réel. Indiquez explicitement l'URL souhaitée.
Vérifier le résultat
Inspectez le message envoyé et ses événements, puis ouvrez la pièce jointe sur un appareil de test Apple autorisé. Vérifiez la lisibilité, le nom du fichier et si le contenu est compréhensible sans le site web environnant.
Si le message échoue après acceptation, inspectez son erreur avant de modifier le modèle. Les causes courantes incluent une URL inaccessible, un type de média inattendu, un fichier dépassant la limite de taille ou des données PNG non valides. Changer l'extension d'un fichier ne convertit pas son format.
Les pièces jointes entrantes peuvent apparaître par nom dans la transcription de la conversation. La transcription ne fournit pas actuellement d'action de téléchargement authentifié pour ces fichiers. Les opérations de récupération des pièces jointes et des médias ne font pas partie de l’API publique. Si votre service nécessite le téléchargement de fichiers entrants, confirmez un flux de récupération disponible auprès de Bird avant d'en dépendre.