Introduction
Multilingual WhatsApp templates allow agents to communicate with customers in their preferred language using pre-approved message templates. This document provides a step-by-step guide on how to use multilingual templates in an IM inbox, covering template selection, language mapping, placeholder management, error handling, and best practices.
Understanding Multilingual Templates in IM Inbox
What Are Multilingual Templates?
Multilingual templates are preapproved WhatsApp message templates that support multiple languages, ensuring customers receive messages in their preferred language.
Why Use Multilingual Templates?
- Customers receive messages in their native language.
- Ensures messages adhere to WhatsApp’s business policies.
- Agents can quickly send pre-approved messages without manual translation.
How Multilingual Templates Work
Each WhatsApp template has a default language (e.g., English) and multiple translations (e.g., Spanish, French, German).
When sending a template message:
- The system retrieves the customer’s preferred language from their profile.
- If the preferred language template is available, it is selected automatically.
- If the preferred language is unavailable, the default language is used.
Steps to Use Multilingual Templates in Inbox
- Navigate to the Inbox and select an active customer chat.
- Click the Template Messages option in the reply area.
- The system preselects the customer’s Preferred Language.
- If necessary, agents can manually Change the Language using a drop-down menu.
- The system displays placeholder input fields.
- Agents must enter relevant data, such as:
- Customer Name:{{1}}
- Order Number:{{2}}
- A preview of the final message with placeholders filled in will be shown.
- Click Send to deliver the message.
Error Handling for Agents
Error Scenario
| Error Message
| Resolution
|
Preferred language template missing
| "Template is not available in customer's preferred language. Sending in the default language."
| Use the default language template.
|
Placeholder data missing
| "Placeholder values are missing or invalid."
| Highlight missing fields and prevent sending until corrected.
|
Template not approved by WhatsApp
| "Selected template is pending WhatsApp approval."
| Notify the admin and suggest selecting another approved template.
|
API submission failed
| "Failed to send the template message. Please try again later."
| Retry sending or escalate the issue to the support team.
|
Agent Workflow Example
Scenario:
- Customer Name: Juan Pérez
- Preferred Language: Spanish (es)
- Template: order_confirmation
Agent Steps
- Open Juan Pérez’s chat.
- Select order_confirmation from the Template Messages menu.
- System automatically selects Spanish (es).
- Fill placeholders:
- {{1}} = Juan Pérez
- {{2}} = #56789
- Preview Message:
- Spanish:"Hola Juan Pérez, tu pedido #56789 está confirmado."
- Click Send.
Customer Receives:
The customer receives the message in Spanish.
- "Hola Juan Pérez, tu pedido #56789 está confirmado."
Best Practices for Agents
- Check the language pre-selected by the system before sending the template.
- Ensure All Placeholders Are Correctly Filled
- Be Aware of Template Approval Status . If a template is pending approval, it cannot be sent.
- If the preferred language is not available, use the default template.
- Notify customers that they are receiving messages in a different language.
- Regularly check analytics to understand which templates and languages are most used.
- Provide feedback for translation improvements when needed.
Troubleshooting & Support
If you encounter issues using multilingual templates:
- Check error messages for missing data or approval status.
- Confirm the customer’s preferred language is correctly set in their profile.
- Contact support if:
- Messages fail to send.
- Templates are not appearing in the inbox.
- Translations need updates.
Frequently Asked Questions (FAQ)
Can I manually select a different language for a customer?
Yes! The language dropdown allows agents to override the pre-selected language if needed.
What happens if a template is not approved by WhatsApp?
The template cannot be sent. Agents should choose another approved template.
Can I add a new translation for a template?
If an approved template lacks a required language, request an admin to add a translation.
How do I know if a customer has a preferred language set?
The system automatically fetches the preferred language from the customer profile.