WhatsApp Template Issues

WhatsApp messages sent through the Sent platform require pre-approved templates. This guide covers the most common issues developers run into when creating, submitting, and using templates, along with solutions for each.

"Failed to save template" / "Failed to submit template for review"

Symptoms: When creating a template in the dashboard and clicking Save or Submit, you see a generic error:

Failed to save template

or

Failed to submit template for review

No additional detail is provided about what went wrong.

Common causes:

• WhatsApp Business Account not connected. Your Meta Business Account must be fully linked to Sent before you can create WhatsApp templates. Go to Dashboard > Settings and verify that your Meta Business Account shows as connected.
• Template body exceeds character limits. WhatsApp enforces a maximum of 1024 characters for the template body. Headers and footers have their own separate limits.
• Prohibited content or formatting. Templates that contain content violating Meta's commerce or messaging policies will be rejected at submission time. This includes certain restricted industries, misleading content, or unsupported formatting.
• Application permission issue. If the error includes the phrase "Application does not have permission for this action," see the dedicated section below.

Solutions:

1. Open Dashboard > Settings and confirm your WhatsApp Business Account is connected and showing a healthy status.
2. Check your template body length. If you are close to the limit, trim the content or split it across multiple messages.
3. Review your template against Meta's template guidelines for prohibited content.
4. Try creating a simple text-only template with no variables, no header, and no buttons. If this succeeds, add complexity incrementally to isolate what is causing the failure.
5. If the error mentions "permission," see the next section.

"Application does not have permission for this action"

Symptoms: When submitting a template for review, you receive:

Failed to submit template for review: Application does not have permission for this action

What's happening:

The Meta Business Account integration with Sent does not have the required permissions to manage templates on your behalf. This typically happens when permissions were not fully granted during the initial WhatsApp Business Account connection flow, or when Meta has revoked permissions due to a policy change.

Solutions:

1. Go to Dashboard > Settings and disconnect your WhatsApp Business Account.
2. Reconnect the account by going through the Facebook OAuth flow again. During the connection process, ensure you grant all requested permissions when prompted. Do not skip or decline any permission scopes.
3. After reconnecting, try submitting your template again.
4. If the issue persists after disconnecting and reconnecting, contact support@sent.dm. Sent support may need to re-authorize the integration, or there may be a configuration issue with your Meta Business Account that requires manual intervention.

Template stuck in PENDING approval

Symptoms: You submitted a template for review, and it has been in "Pending" status for an extended period with no updates.

What's happening:

WhatsApp templates go through Meta's review process before they can be used to send messages. This is a Meta-side process that Sent does not control.

Typical timeline:

• Most templates are reviewed within 24-48 hours.
• During peak periods or for templates in certain categories, reviews can take longer.
• Templates with media (images, videos, documents) may take slightly longer than text-only templates.

What to do:

1. If pending for less than 48 hours: Wait. This is within the normal review window.
2. If pending for more than 48 hours:
   • Log into Meta Business Manager directly and navigate to your WhatsApp account's message templates. Meta sometimes provides additional context or action items there that are not surfaced in the Sent dashboard.
   • Contact support@sent.dm and ask Sent support to check the template status. Include your template name and the approximate date you submitted it.
3. If you need to send messages now: Create and use an SMS template instead. SMS templates on Sent do not require external approval and can be used immediately after creation.

Template categorized incorrectly by Meta

Symptoms: You submitted a template as Utility (transactional), but Meta re-categorized it as Marketing. Alternatively, you expected one category but received another after approval.

Why this matters:

• Marketing templates are subject to stricter delivery rules, including per-user frequency caps. If a recipient has received too many marketing messages recently, your message may not be delivered.
• Utility templates (order confirmations, shipping updates, OTP codes, account alerts) have more lenient delivery rules because they contain information the recipient is expecting.
• Authentication templates (OTP codes, verification) have the highest delivery priority.

What to do:

1. Review your template content. Meta categorizes templates based on the language and intent of the content, not the category you select during creation. Common triggers for marketing categorization include:
   • Promotional language ("Get 20% off," "Limited time offer," "Shop now")
   • Upselling or cross-selling content
   • General announcements not tied to a specific user action
2. Appeal through Meta Business Manager. Log into Meta Business Manager, navigate to your template, and submit a category appeal if you believe the categorization is incorrect.
3. Contact Sent support. The team can also submit an appeal on your behalf. Email support@sent.dm with the template name and your reasoning for why it should be categorized differently.

To avoid miscategorization in the first place:

• Do not include any promotional language in utility or authentication templates.
• Keep the content focused on the specific transaction or event that triggered the message (e.g., "Your order #12345 has shipped" rather than "Your order has shipped! Check out our new arrivals").
• Avoid including links to product pages, promotional landing pages, or anything not directly related to the transaction.

Template variables / parameters mismatch

Symptoms: Your template is approved and visible in the dashboard, but messages fail when you attempt to send them. The error indicates a parameter or variable mismatch.

What's happening:

WhatsApp templates use numbered variables in the format {{1}}, {{2}}, {{3}}, and so on. When you send a message using a template, you must provide a value for every variable defined in the template, in the correct order.

Common mistakes:

• Wrong number of parameters. If your template has three variables ({{1}}, {{2}}, {{3}}), you must provide exactly three values. Providing two or four will cause the send to fail.
• Parameters in wrong order. Variables are positional. {{1}} is always the first parameter, {{2}} the second, and so on.
• Missing parameters array. The template object in your API call must include a parameters array with the variable values.

Example:

If your approved template body is:

Hi {{1}}, your order {{2}} has been shipped and will arrive by {{3}}.

Your API call should include:

await client.messages.send({
  to: ['+14155552671'],
  template: {
    id: 'tmpl_shipping_update',
    parameters: ['Alex', 'ORD-98765', 'March 25']
  },
  sender_profile_id: 'sp_your_profile_id'
});

Debugging tips:

1. Open the template in the dashboard and count the number of variables in each section (header, body, buttons). Each section's variables are numbered independently.
2. Ensure your parameters array length matches the total variable count.
3. Test with hardcoded string values first before using dynamic data from your application.

Template Best Practices

Following these guidelines will help you avoid common issues with template creation and approval.

Keep templates concise and transactional. Templates that clearly serve a transactional or utility purpose (order updates, appointment reminders, verification codes) are approved faster and categorized correctly more often than templates with ambiguous intent.

Avoid marketing language in utility templates. Even a single promotional phrase can cause Meta to re-categorize your utility template as marketing. Stick to factual, action-oriented language that directly relates to the triggering event.

Test with a simple text-only template first. Before building a template with media, buttons, and multiple variables, create and send a basic text-only template. This confirms your WhatsApp Business Account connection, permissions, and API integration are all working correctly. Add complexity from there.

Use meaningful template names. Template names cannot be changed after creation. Use descriptive, consistent names like order_confirmation, shipping_update, or otp_verification rather than generic names like template1 or test. This makes templates easier to manage as your library grows.

Plan for approval time. Build template review time into your development workflow. Submit templates for approval well before you need them in production. Having a library of pre-approved templates ready to go prevents delays when launching new features.

Still need help?

If you have worked through the steps above and your template issue is not resolved, contact the Sent support team:

• Email: support@sent.dm
• Include: Your template name, the error message you are seeing (exact text or screenshot), and whether this is a new template or one that was previously working.
• Response time: The support team typically responds within 1 business day.

Related Guides

• Messages Not Delivered — if your template is approved but messages still fail to deliver
• WhatsApp Setup — if you're unable to create templates because your WhatsApp Business Account is not connected
• Compliance & 10DLC Issues — for SMS-specific compliance and A2P registration requirements