On this page
Sync from Meta pulls every template on your connected WhatsApp Business Account straight from Meta's own records into VGraple CRM: name, status, category, language and full component structure. Most of the time you will never need it, since VGraple CRM's own submissions and Meta's webhooks keep templates current automatically; sync exists for the moments they cannot.
Sync with Meta
- 1Click Sync from Meta
- 2VGraple CRM calls Meta for every template
- 3Each template is saved or updated
- 4One bad row does not stop the
- 5The result is reported directly on the
Before you start
- You need "View templates" permission to run a sync; it does not require the create or edit permission, since it only reads from Meta.
- A connected WhatsApp Business Account is required; the Sync button is disabled until Meta API setup is complete for your workspace.
- Sync reads from Meta only. Nothing you have edited locally is ever sent to Meta by this action.
Steps
- Click Sync from Meta. The button sits at the top of the Templates page, next to Meta's Library, Browse Gallery and New Template.
VGraple CRM calls Meta for every template on your WABA. This walks Meta's own template list for the connected WhatsApp Business Account (or Accounts, if your workspace has more than one), paging through in batches of 200 until every template has been read.
Each template is saved or updated. For every template Meta returns, VGraple CRM writes its current name, status, category, language, quality score, rejection reason (if any) and full component breakdown (header, body, footer, buttons, carousel or limited-time offer) into your workspace's record.
One bad row does not stop the rest. If a single template's data cannot be saved for some reason, the sync logs it and continues with the remaining templates rather than aborting the whole run.
The result is reported directly on the button. "Synced [n] templates" on success, or, if some templates could not be read, "Synced [n], [m] could not be read: [first error]." The page reloads automatically a moment after a clean sync so the updated list is visible immediately.
What you will see
Templates that already existed in VGraple CRM update in place, keeping their history (approval stats, performance data, edit history) intact. Templates that existed at Meta but not in VGraple CRM, created directly in WhatsApp Manager, for example, appear as new rows. Nothing is ever deleted from VGraple CRM by a sync; a template Meta no longer returns simply stops updating rather than being removed.
Settings and options
| Setting or field | What it does | Default |
|---|---|---|
| Sync from Meta button | Manually pulls every template on the connected WABA(s) from Meta | Manual, on demand; disabled until Meta API setup is complete |
| Automatic status updates | Meta's message_template_status_update webhook keeps Approved, Rejected, Paused and Disabled current without a manual sync | Always on |
| Automatic quality updates | Meta's message_template_quality_update webhook keeps the GREEN/YELLOW/RED quality score current | Always on |
| Automatic category updates | Meta's template_category_update webhook catches a recategorisation the moment it happens | Always on |
When you actually need this
Sync is a reconciliation tool, not a routine step. The cases where it earns its place:
- A template was created, edited or deleted directly in Meta's WhatsApp Manager rather than through VGraple CRM, and needs to show up here.
- Your workspace recently connected a WhatsApp Business Account that already had templates on it before VGraple CRM was involved.
- You suspect a webhook was missed (rare, but possible during a Meta-side outage) and want to confirm the current state directly rather than wait.
- You changed which WhatsApp Business Account a channel points to and want templates re-read against the new one.
For everything else, submissions, edits, approvals, rejections, pauses and recategorisations, VGraple CRM already keeps itself current automatically.
Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| Sync button is greyed out | Meta API setup is not complete for this workspace | Finish connecting your WhatsApp number first |
| "No WhatsApp Business Account is connected yet" | Sync ran but found no linked WABA at all | Connect a WhatsApp number under Settings, Channels before syncing |
| "Could not read templates from WhatsApp" | Meta's API returned an error for the whole request, often an expired or invalid access token | Check the WhatsApp channel card for a token warning and reconnect if needed |
| "Synced [n], [m] could not be read" | Individual templates failed to save, usually from unexpected data in a component Meta returned | The successfully synced templates are already updated; contact support with the error shown if the same templates keep failing |
| Template still shows the old status after syncing | The page has not refreshed, or the sync completed after the page loaded | Refresh the Templates page; a successful sync also reloads automatically after a short pause |
Related reading
Most day-to-day status changes reach you automatically as alerts rather than needing a sync at all; see template paused or disabled by Meta and template analytics and approval stats for what those automatic updates look like.