contacts_discover
Search for a contact on a live channel (Telegram, WhatsApp, etc.) before adding them. Use this to look up a person by username or phone number before calling contacts.sync. This is the right tool when asked to add or find a specific person by @username or phone (use contacts.sync afterwards to actually add them) — not group_discovery.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>",
"channel": "<channel>"
},
"name": "contacts_discover"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Username, phone, or name to search for | |
| channel | Yes | Channel name: telegram, whatsapp, etc. | |
| in_workspace | No | Run this one call in this workspace id instead of the session's. Nothing is stored; other sessions are not affected. |