Yaplet's blocklist works across every channel: block someone from chat, and they cannot call your voice agent either. Blocked calls are rejected before the agent picks up — there is no greeting, no Gemini session, and no per-minute charge. This article shows how to add and remove blocks.
How blocking works
Before the greeting plays on every inbound call, Yaplet runs a preflight check against your organization's blocklist:
- If the caller's phone number matches a blocked visitor record, Yaplet tells Telnyx to hang up immediately — the call never reaches your agent.
- There is no ring, no greeting, and no Gemini session is opened.
- No per-minute charge accrues because the call was never set up.
Blocks are org-wide. They apply to every phone number and every Vex chatbot in your workspace — you do not block per number.
How to block a caller
You can only block a caller who has already reached you at least once, because Yaplet needs a visitor record to attach the block to.
From the inbox
- Open the call thread or chat thread from the unwanted caller in your inbox.
- Click the visitor's name or avatar in the sidebar to open their visitor profile.
- Click Block visitor.
The next time that phone number calls, the call is rejected before it rings.
From Security → Visitors
If you want to manage multiple blocks at once, open Dashboard → Security → Visitors. From here you can:
- See every blocked visitor in your workspace.
- Block a visitor by visitor ID.
- Unblock a visitor.
How to unblock a caller
Open the visitor's profile (either from the inbox or from Dashboard → Security → Visitors) and click Unblock. The block is removed immediately. The next call from that number will be answered normally.
Can I block a number that has never called me?
Not directly. Yaplet only creates a visitor record when someone first reaches you, so there is no record to attach a block to before the first call. If you know in advance that a specific number needs to be blocked — for example, a known abuser from another platform — contact support and we can pre-create the block manually.
The first call from any caller will always get through. After it, the block applies on every subsequent call. There is no way for the agent to filter the first contact from someone you have never heard of.
What blocked callers experience
Blocked callers hear what the carrier plays for a rejected call — typically a brief busy tone or a "user busy" message, depending on their network. They do not hear a Yaplet-specific message or know that they have been blocked.
Does blocking apply to recordings and transcripts?
Because a blocked call is rejected before any session is created, there is no recording, transcript, or inbox thread for blocked attempts. If you need an audit trail of rejected callers, that is not currently surfaced — contact support if you have a compliance requirement and we will help.
What to read next
For everything you can do with the visitor blocklist beyond voice — including chat blocking, custom security rules, and the audit log — see the security and privacy section of the knowledge base.