engineer-localization

Integrate translation management systems with Braze for automated content localization.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/delta-and-beta/braze-agency --skill engineer-localization
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: engineer-localization
Source: https://github.com/delta-and-beta/braze-agency/tree/main/skills/engineer-localization
Command: npx skills add https://github.com/delta-and-beta/braze-agency --skill engineer-localization

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Engineers and platform integrators often struggle to reliably connect Braze with translation management systems, manage authentication differences, and keep localized content synchronized without overwriting production assets or mismatching locale codes. This skill reduces integration drift by documenting pipeline patterns, authentication methods, webhook orchestration, content format expectations, and staging best practices.

Core Features & Use Cases

  • Integration Blueprints: Clear, scan-friendly setup steps for Transifex, Smartling, Phrase, Lokalise, LILT, Crowdin, and Tangerine including required API endpoints and mapping guidance.
  • Auth & Pipeline Patterns: Quick reference for bearer tokens, OAuth client credentials, basic auth, and the distinction between Push-Pull exports and Connected Content at-send-time calls.
  • Operational Guidance: Recommendations for webhooks vs polling, locale normalization to BCP 47, staging translated templates in separate workspaces, and avoiding credential leakage in message bodies.
  • Use Case: Configure a Transifex Push-Pull workflow to export campaign strings from Braze, trigger translations, and reimport localized templates into a QA workspace before production rollout.

Quick Start

Create a step-by-step implementation plan to export Braze message strings, map locale keys, and configure authentication and webhooks to implement a Push-Pull integration with a translation management system.

Frequently Asked Questions about engineer-localization

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate Braze with a translation management system for localized campaign content?

Braze localization integration connects translation management systems to automate exporting content, managing translations, and reimporting localized assets. It supports configuring Push-Pull and Connected Content pipelines for partners like Transifex, Smartling, and Lokalise.

What is the difference between Push-Pull exports and Connected Content for Braze translations?

Push-Pull exports Braze message strings for translation and reimports localized templates, while Connected Content makes at-send-time API calls to fetch translated content dynamically. Both patterns require handling webhook or polling orchestration.

Does this Braze localization integration support OAuth and bearer token authentication?

Yes, Braze localization pipelines handle multiple API authentication patterns including bearer tokens, OAuth client credentials, and basic auth. This ensures secure connections across supported translation management platforms.

How do I normalize locale keys and stage translated Braze templates safely?

Normalize locale keys to BCP 47 standards and stage translated templates in separate QA workspaces before production rollout. This prevents overwriting production assets and avoids credential leakage in message bodies.

Can I use Connected Content to fetch XLIFF or JSON translations from Smartling or Crowdin?

Yes, Braze localization pipelines support content mapping for JSON and XLIFF formats across translation management systems including Smartling, Crowdin, Phrase, LILT, and Tangerine for campaign and Canvas workflows.

What are the limitations of using webhooks vs polling for Braze translation orchestration?

Webhooks provide real-time translation updates but require stable endpoints, while polling offers reliability if translation management systems lack webhook support. Choose based on your platform's API capabilities and latency requirements.