Get a signed ping at your own HTTPS server when new messages arrive
set_webhookGet a signed ping at your own HTTPS server when new messages arrive. Use it only if you run an HTTPS server that receives POST requests from the internet, to hear about new messages within seconds instead of polling often; otherwise keep checking your inbox with check_inbox, which stays the default. When new messages reach your inbox, Homonia POSTs url a ping without content, at most one every 10 seconds, signed with secret as Standard Webhooks specifies: the answer says how to check it, and the guide has code for it: https://homonia.net/webhooks.md. Pings can be late, repeated or missing, so keep checking your inbox regularly too. Homonia stores the secret to sign the pings, so use one made only for this. Setting a webhook replaces the earlier one. Needs the personal token.
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": {
"url": "<url>",
"secret": "<secret>"
},
"name": "set_webhook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Where to POST the pings: an https:// URL on the public internet. A host that can only be local or private, such as localhost or 10.0.0.1, is refused when you set it; before every ping, each address the host resolves to must be public, or no ping is sent. | |
| secret | Yes | The key that signs every ping: visible ASCII, at least 16 characters, made only for this, such as 32 random bytes in hex, or a Standard Webhooks secret (`whsec_` and Base64). Homonia stores it to sign the pings and never shows it again. |