Get an Apple Messages template version's language
/v1/amb/templates/{template_ref}/versions/{version_id}/languages/{language}const language = await bird.amb.templates.versions.languages.get(
"bird_order_update",
"amv_01ky4x8e4genzb7way45txfkm1",
"en",
);
console.log(language.language, language.content);language = client.amb.templates.versions.languages.get(
"bird_order_update", "amv_01ky4x8e4genzb7way45txfkm1", "en"
)
print(language.language, language.content)language, err := client.Amb.Templates.Versions.Languages.Get(context.Background(), "bird_order_update", "amv_01ky4x8e4genzb7way45txfkm1", "en")
if err != nil {
log.Fatal(err)
}
fmt.Println(language.Language, language.Content)$language = $bird->amb->templates->versions->languages->get(
'bird_order_update',
'amv_01ky4x8e4genzb7way45txfkm1',
'en',
);
echo $language->getLanguage(), ' ', $language->getRevision();bird amb templates versions languages get <template-ref> <version-id> <language>curl -X GET "https://us1.platform.bird.com/v1/amb/templates/{template_ref}/versions/{version_id}/languages/{language}" \
-H "Authorization: Bearer $TOKEN"{
"language": "en",
"content": {
"type": "text",
"body": "Your order {{ order_number }} is on its way."
},
"revision": 1,
"content_hash": "sha256:3d948846f5f773fb7bed8ab81b57f3d0ff2cbff24cb549718f4d389f1ab0300a",
"updated_at": "2026-09-10T09:00:00Z"
}
Returns one language's full text, revision, content hash, and update time. The response echoes the language in its canonical BCP-47 form.
Paramètres
template_refstringThe template's ID (amt_…) or slug.
version_idstringThe version that holds the language.
languagestringThe language as a BCP-47 tag. Case and separator differences are accepted and canonicalized.
Contenu de la réponse
languageThe language in canonical BCP-47 form.
contentStored template content, including its {{ variable }} placeholders.
Afficher les attributs enfants
content.typeAlways text.
Value: text
content.bodyText displayed in the message. Use one U+FFFC object replacement character per attachment to control placement.
content.subjectSubject displayed above the message body.
content.attachmentsOrdered attachments. Each object supplies a source URL or an encrypted Apple reference.
content.typeAlways rich_link.
Value: rich_link
content.bodyAutomatic introductions for rich links are enabled regionally in stages. When enabled for a new send, a nonblank body is sent as a separate text before the link. All parts belong to one message, which becomes sent after Apple accepts all parts. Before activation, and for retries retaining legacy behavior, body is included in the rich link request and is not guaranteed to appear on the device. To ensure an introduction without relying on activation, send a separate text message and omit body from the rich link. Use one U+FFFC object replacement character per attachment to control placement.
content.subjectSubject displayed above the message body.
content.attachmentsOrdered attachments. Each object supplies a source URL or an encrypted Apple reference.
content.rich_link_datacontent.rich_link_data_refReusable Apple content reference. Supply the decryption key, or the signed bid and data_ref_sig returned by Apple.
content.rich_link_constructAsks Apple to build the rich link preview when the message is sent, rather than through a prior POST /v1/amb/messages/construct-payload call. No caller holds a signed reference until the send itself resolves one.
content.typeAlways interactive.
Value: interactive
content.bodyAutomatic introductions for inline quick replies are enabled regionally in stages. When enabled for a new send containing interactive_data.data.quick_reply, a nonblank body is sent as separate text before the choices. Messages using interactive_data_ref do not receive this automatic introduction, even after activation. All parts belong to one message, which becomes sent after Apple accepts all parts. For referenced interactions, before activation, and for retries retaining legacy behavior, body is included in the interactive request and is not guaranteed to appear on the device. To ensure an introduction without relying on activation, send a separate text message and omit body from the quick reply. Omit body to send choices only. For list pickers, time pickers and forms, use interactive_data.received_message for the visible introduction. Use one U+FFFC object replacement character per attachment to control placement.
content.subjectSubject displayed above the message body.
content.attachmentsOrdered attachments. Each object supplies a source URL or an encrypted Apple reference.
content.interactive_dataA built-in interaction or custom iMessage app. Custom apps require the app metadata and both message bubbles.
Afficher les attributs enfants
content.interactive_data.session_identifierSession UUID to preserve across interactions. Apple creates one when omitted.
content.interactive_data.dataExactly one built-in interaction. Protocol versions are managed by Bird.
content.interactive_data.app_idApp Store identifier of the iMessage app.
content.interactive_data.app_nameName of the iMessage app.
content.interactive_data.bidIdentifier of the iMessage extension, in Apple's com.apple.messages.MSMessageExtensionBalloonPlugin:team-id:extension-id format.
content.interactive_data.urlOpaque URL string that Messages passes to the iMessage app.
content.interactive_data.use_live_layoutWhether Messages renders the received and reply bubbles using Live Layout.
content.interactive_data.session_identifierSession UUID to preserve across interactions. Apple creates one when omitted.
content.interactive_data.received_messageContent Messages shows in the received message bubble.
content.interactive_data.reply_messageContent Messages shows in the reply message bubble.
content.interactive_data.app_icon_source_urlPublicly accessible HTTPS URL of the app's PNG icon. The icon must be smaller than 15 kB. We fetch and include it in the request to Apple.
content.interactive_data_refReusable Apple content reference. Supply the decryption key, or the signed bid and data_ref_sig returned by Apple.
revisionThis language's revision counter, used for concurrent-edit checks on draft writes.
content_hashA fingerprint of Apple Messages template content, prefixed with its algorithm. Compare it within this API version to identify the exact source without transferring it.
updated_atWhen this language was last saved. Null for a built-in template.
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet.