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.text);language = client.amb.templates.versions.languages.get(
"bird_order_update", "amv_01ky4x8e4genzb7way45txfkm1", "en"
)
print(language.language, language.text)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.Text)$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",
"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.
Parameter
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.
Antwort-Payload
languageThe language in canonical BCP-47 form.
textStored text and files. Includes its {{ variable }} placeholders.
rich_linkStored link preview. Includes its {{ variable }} placeholders.
interactiveStored interaction. Includes its {{ variable }} placeholders.
Untergeordnete Attribute anzeigen
interactive.session_identifierSession UUID to preserve across interactions. Apple creates one when omitted.
interactive.request_identifierCorrelation identifier for this interaction. Bird generates one when omitted. Use a new value for each message. A reply is linked to its request only when no other sent message in the conversation uses the same identifier.
interactive.imagesImages the interaction references by image_identifier, such as list picker thumbnails.
Untergeordnete Attribute anzeigen
interactive.images.identifierIdentifier referenced by a bubble, item, or event.
interactive.images.source_urlHTTPS URL of a PNG image up to 200 kB. Total interactive image data must not exceed 5 MB. A non-HTTPS URL is refused with a 422 AMBEndpointNotHTTPS. In a template it may contain {{ }} placeholders; the rendered value must be HTTPS.
interactive.images.descriptionAccessibility description read by VoiceOver.
interactive.quick_replyinteractive.session_identifierSession UUID to preserve across interactions. Apple creates one when omitted.
interactive.request_identifierCorrelation identifier for this interaction. Bird generates one when omitted. Use a new value for each message. A reply is linked to its request only when no other sent message in the conversation uses the same identifier.
interactive.imagesImages the interaction references by image_identifier, such as list picker thumbnails.
Untergeordnete Attribute anzeigen
interactive.images.identifierIdentifier referenced by a bubble, item, or event.
interactive.images.source_urlHTTPS URL of a PNG image up to 200 kB. Total interactive image data must not exceed 5 MB. A non-HTTPS URL is refused with a 422 AMBEndpointNotHTTPS. In a template it may contain {{ }} placeholders; the rendered value must be HTTPS.
interactive.images.descriptionAccessibility description read by VoiceOver.
interactive.list_pickerinteractive.session_identifierSession UUID to preserve across interactions. Apple creates one when omitted.
interactive.request_identifierCorrelation identifier for this interaction. Bird generates one when omitted. Use a new value for each message. A reply is linked to its request only when no other sent message in the conversation uses the same identifier.
interactive.imagesImages the interaction references by image_identifier, such as list picker thumbnails.
Untergeordnete Attribute anzeigen
interactive.images.identifierIdentifier referenced by a bubble, item, or event.
interactive.images.source_urlHTTPS URL of a PNG image up to 200 kB. Total interactive image data must not exceed 5 MB. A non-HTTPS URL is refused with a 422 AMBEndpointNotHTTPS. In a template it may contain {{ }} placeholders; the rendered value must be HTTPS.
interactive.images.descriptionAccessibility description read by VoiceOver.
interactive.eventinteractive.session_identifierSession UUID to preserve across interactions. Apple creates one when omitted.
interactive.request_identifierCorrelation identifier for this interaction. Bird generates one when omitted. Use a new value for each message. A reply is linked to its request only when no other sent message in the conversation uses the same identifier.
interactive.imagesImages the interaction references by image_identifier, such as list picker thumbnails.
Untergeordnete Attribute anzeigen
interactive.images.identifierIdentifier referenced by a bubble, item, or event.
interactive.images.source_urlHTTPS URL of a PNG image up to 200 kB. Total interactive image data must not exceed 5 MB. A non-HTTPS URL is refused with a 422 AMBEndpointNotHTTPS. In a template it may contain {{ }} placeholders; the rendered value must be HTTPS.
interactive.images.descriptionAccessibility description read by VoiceOver.
interactive.dynamicForm content. Bird supplies Apple’s messageForms template and protocol version.
interactive.received_messageContent Messages shows in the received message bubble. For a list picker, time picker or form, this is the visible introduction.
interactive.reply_messageContent Messages shows in the reply message bubble.
interactive.session_identifierSession UUID to preserve across interactions. Apple creates one when omitted.
interactive.request_identifierCorrelation identifier for this interaction. Bird generates one when omitted. Use a new value for each message. A reply is linked to its request only when no other sent message in the conversation uses the same identifier.
interactive.imagesImages the interaction references by image_identifier, such as list picker thumbnails.
Untergeordnete Attribute anzeigen
interactive.images.identifierIdentifier referenced by a bubble, item, or event.
interactive.images.source_urlHTTPS URL of a PNG image up to 200 kB. Total interactive image data must not exceed 5 MB. A non-HTTPS URL is refused with a 422 AMBEndpointNotHTTPS. In a template it may contain {{ }} placeholders; the rendered value must be HTTPS.
interactive.images.descriptionAccessibility description read by VoiceOver.
interactive.imessage_appA custom iMessage app interaction. It also requires both received_message and reply_message.
interactive.session_identifierSession UUID to preserve across interactions. Apple creates one when omitted.
interactive.request_identifierCorrelation identifier for this interaction. Bird generates one when omitted. Use a new value for each message. A reply is linked to its request only when no other sent message in the conversation uses the same identifier.
interactive.imagesImages the interaction references by image_identifier, such as list picker thumbnails.
Untergeordnete Attribute anzeigen
interactive.images.identifierIdentifier referenced by a bubble, item, or event.
interactive.images.source_urlHTTPS URL of a PNG image up to 200 kB. Total interactive image data must not exceed 5 MB. A non-HTTPS URL is refused with a 422 AMBEndpointNotHTTPS. In a template it may contain {{ }} placeholders; the rendered value must be HTTPS.
interactive.images.descriptionAccessibility description read by VoiceOver.
interactive.paymentApple Pay request created through the conversation payment endpoint. Contains no payment token or provider credentials.
interactive.session_identifierSession UUID to preserve across interactions. Apple creates one when omitted.
interactive.request_identifierCorrelation identifier for this interaction. Bird generates one when omitted. Use a new value for each message. A reply is linked to its request only when no other sent message in the conversation uses the same identifier.
interactive.imagesImages the interaction references by image_identifier, such as list picker thumbnails.
Untergeordnete Attribute anzeigen
interactive.images.identifierIdentifier referenced by a bubble, item, or event.
interactive.images.source_urlHTTPS URL of a PNG image up to 200 kB. Total interactive image data must not exceed 5 MB. A non-HTTPS URL is refused with a 422 AMBEndpointNotHTTPS. In a template it may contain {{ }} placeholders; the rendered value must be HTTPS.
interactive.images.descriptionAccessibility description read by VoiceOver.
interactive.authenticateAuthentication attempt created through the conversation authentication endpoint. Contains no authorization parameters or credentials.
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.
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.