Callbots handbook (draft)
Written Nov 3, 2026 by Callbots (the project keeper) from read-only research, then verified and corrected by Coder against the code and Render deploy records.
Callbots is the AI phone-bot framework behind the Best Deal On line (727) 632-0002, served by the Render service callbots-bdo. Callers talk to xAI Grok Voice. The code lives in the GitHub repo WPAGI/rfsafe-phone-agent. It runs on Render.
Where the code is (as of this draft)
| Ref | Commit | What runs it |
|---|---|---|
main | — | Out of scope (RF Safe). |
bestdealon branch | ee5b1f2 (live, verified from Render) | Best Deal On, Render service callbots-bdo. This branch never merges to main. |
Verified Nov 3, 2026, 11:40 PM EST against Render deploy records (Coder): callbots-bdo (
srv-dbl01inf3r2c7382v4c0) runs rfsafe-phone-agentbestdealon@ee5b1f2(deploydep-dbla0lajnfac73fblnlg, live 10:03 PM EST Nov 3). Flags:BDO_VERIFY_CALLSon (live mode),BDO_INBOUND_CLAIMoff (unset), tenantbdo_caller_lookupon,bdo_claimsoff (absent); bestdealon.appCALLER_LOOKUPon,CALL_VERIFYon,INBOUND_CLAIMoff.
A citation like src/app.js:177 means main (shared framework code). A citation marked [bdo] means the bestdealon branch. A citation marked [PR #42] means that PR's head commit.
The callbots-bdo /health endpoint returned {"ok":true,"tenants":1,"active_calls":0,"mode":"live"} at 11:31 PM EST on Nov 3.
Pages
| File | What it covers |
|---|---|
| how-it-works.md | Call flow and its branches, Twilio, Grok Voice, Render, Resend, the admin dashboard, health and drain. Includes Mermaid diagrams. |
| standalone-framework.md | Callbots without Best Deal On pages: tenants, brand, the KB template, and how an owner customizes the bot. |
| settings.md | Every tenant JSON field and env var, with defaults, file:line, and examples. |
| knowledge-base.md | How the bot answers from the KB, the two bundle formats, and gaps. |
| caller-recognition.md | Caller ID, known callers, returning subscribers, and the Best Deal On profile lookup. |
| verify-by-call.md | Best Deal On's listing-verification call ([bdo], off by default). |
| texting.md | The A2P gate and the email fallback through Resend. |
| changelog | Merged into the single platform changelog (Render deploy records, EST). |
| agents/ | One AGENT.md per phone-side agent. Each is marked exists today or proposed. |
Status labels used here
- Live: running on callbots-bdo (deploy
ee5b1f2). - [bdo]: on the bestdealon branch. Everything up to
ee5b1f2is deployed on callbots-bdo (checked against Render). - Planned: not built. Only described in plans.
- Off by default: built, but a flag keeps it off.
Rules for this handbook
- No secrets, keys, or private numbers. Only env var names.
- The only phone numbers shown are the public Best Deal On line (727) 632-0002.