Skip to main content

Support

Support happens in Chatwoot. The support bot can search people, inspect public provenance, and create internal reports for the team.

Support Bot​

The Chatwoot bot lives in workers/support-bot and deploys as the separate Cloudflare Worker venezuela-te-busca-support-bot.

bun run support-bot:dev
bun run support-bot:deploy

Configure Chatwoot to send inbox webhooks to:

https://<worker-url>/chatwoot/webhook

Set Chatwoot's webhook secret to match CHATWOOT_WEBHOOK_SECRET. The Worker verifies X-Chatwoot-Timestamp and X-Chatwoot-Signature before processing the event.

Required Worker secrets:

CHATWOOT_ACCOUNT_ID
CHATWOOT_API_TOKEN
CHATWOOT_HANDOFF_TEAM_ID
CHATWOOT_WEBHOOK_SECRET
OPENROUTER_API_KEY
VTB_API_KEY

The VTB API key should be scoped to the minimum permissions needed by the bot. The bot uses OpenRouter and AI SDK tools to search people, inspect public provenance, create internal reports, or hand the conversation to the Chatwoot team.

Human Handoff​

Hand off to the team when a user asks to:

  • create, edit, delete, merge, or restore a person record.
  • mark someone found or missing.
  • correct a sensitive status.
  • report a fake, abusive, duplicate, or incorrect record.
  • ask for private phone or email data.

Privacy​

Never expose private phone numbers or emails in chat. Questions about who reported, who found, or where a record came from can use public provenance fields, but keep private contact fields out of the reply.