Reference
discovery.keyword_signal — Keyword signal
A message in a watched group matched a keyword.
View MarkdownThis page is generated from the source code on every release.
A message in a watched group matched a keyword.
Since web 1.0.0, worker —.
| Name | Value |
|---|---|
| Code | discovery.keyword_signal |
| Group | Groups & channels |
| Status | Subscribable |
| Scope needed to receive it | crm.read |
| Tied to one account | Yes |
| Only the connection that caused it receives it | No |
| Filters that apply | keywords |
Fields dropped in thin content mode |
text, group.title |
| Fields written by outside people (untrusted) | text, group.title |
JSON Schema
https://tlg.builera.app/schemas/events/discovery.keyword_signal/2.json
Sample payload (exactly what webhooks.test sends)
{
"specversion": "1.0",
"id": "evt_01JDOCSSAMPLE",
"source": "https://tlg.builera.app/ws/07c2e5e1-c42f-4212-851b-c55b6dd7989d",
"type": "discovery.keyword_signal",
"time": "2026-10-21T13:45:00.123Z",
"datacontenttype": "application/json",
"dataschema": "https://tlg.builera.app/schemas/events/discovery.keyword_signal/2.json",
"platform": "telegram",
"workspaceid": "07c2e5e1-c42f-4212-851b-c55b6dd7989d",
"accountid": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
"seq": "000000000000000",
"schemaversion": "2",
"correlationid": null,
"causationid": null,
"test": true,
"replay": false,
"data": {
"signal_id": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a",
"group": {
"id": null,
"conversation_id": "5b7c9d1e-2f3a-4b5c-8d9e-0f1a2b3c4d5e",
"tg_chat_id": "-1001234567890",
"title": "Nhóm Khách VIP",
"kind": "supergroup"
},
"person_id": "c41b7e2a-9d3c-4b1f-8e2a-7c5d3b1f9e08",
"account": {
"id": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
"label": "Sale 1",
"username": "sale_demo_1",
"tg_user_id": "100200300"
},
"matched": [
"nhà cung cấp"
],
"text": "Mình đang tìm nhà cung cấp áo thun",
"sent_at": "2026-10-21T13:45:00.123Z",
"untrusted_fields": [
"text",
"group.title"
]
}
}