Say hello
event_say_helloSends a hello (a connection request) from the person to somebody listed in their event matches; when it is accepted, a conversation opens that both can read and answer from the app, the web page or an assistant. Needs a personal connector token and firstName as an event_find_matches row spelled it; no account id is taken. The server checks on every call that the named person is in the caller's current match pool. It is a single call: the hello is sent when the call succeeds. Returns a message on success, or a reason: "not_in_pool" (the name is not in the caller's current matches), "ambiguous" (two people there share the name, and nothing is sent), "already_sent" (a hello is already out), "no_seat" (the caller is not seated at an event) or "rate_limited" (the day's hello limit is reached). Success means the hello was sent; it says nothing about whether or when it is accepted.
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": {
"firstName": "<firstName>"
},
"name": "event_say_hello"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| firstName | Yes | The first name of the person, as an event_find_matches row spelled it, up to 40 characters; no surname and no account id. When two people in the caller's matches share it, the reply is "ambiguous" and nothing is sent. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | ||
| sent | No | ||
| error | No | ||
| mutual | No | ||
| reason | No | ||
| message | No | ||
| servedBy | No | ||
| firstName | No | ||
| candidates | No |