¶ Visible tag
An agent can see a tag on a conversation or contact and reasonably believe the person is included in a segment.
Operations
¶ Tag Reconciliation
Repair historical drift between tag association tables. ReplyBox has one org-wide Tag catalog, but tags can appear inconsistent when conversation, contact-directory, and legacy contact associations fall out of sync.
One org-wide catalog
Broadcast audiences depend on directory tags
Repair with
reconcile-tags
First move
¶ Run the repair before hand-editing data
The command reports and repairs historical drift. Use it when a tag is visible in one surface but audience filters or contact-directory state disagree.
Run from the API app
cd apps/api
python -m app.cli reconcile-tagsWhy it matters
¶ Drift can silently shrink campaign audiences
The directory side is load-bearing for broadcasts because audience filters read contact-directory tags.
Data model
¶ One catalog, three association tables
¶ tags
The org-wide tag catalog. It names the tag once for the workspace.
¶ conversation_tags
Conversation-level association used by inbox workflows and historical conversation context.
¶ contact_directory_entry_tags
The broadcast-critical directory association. Audience filters use this side.
¶ contact_tags
Legacy contact association that can participate in historical drift and repair.
When to run
¶ Use it for mismatched visibility, not every tag question
Reconciliation is for data drift. If the product behavior itself is unclear, start with the tags product guide first.
Tag appears in inbox but a broadcast saved filter excludes expected contacts.
Contact-directory tag state disagrees with conversation or contact tag state.
Historical imports or old data paths left associations incomplete.
Do not include
crm_card_tags; CRM card labels stay outside tag mirroring, broadcast filters, and reconcile-tags.
Triage flow
¶ Confirm the symptom, run repair, then record the outcome
¶ Identify the mismatch
Capture the tag name, workspace, contact, conversation, and affected broadcast or saved filter.
¶ Run reconcile-tags
Let the command report and repair historical drift before attempting direct database edits.
¶ Re-check the audience source
Verify contact_directory_entry_tags now matches the expected segment behavior.
¶ Leave evidence
Record the command output, affected ids, and whether this was drift, product misunderstanding, or a new bug.