Search conversations
Conversations that match a ticket number, name, phone number, email address or keywords.
MCP tool trengo_read → search_conversations
read
Runs the inbox search and returns matches in the same shape as list_conversations. The query takes a ticket number, a contact name, a phone number, an email address, a whole email domain such as @example.com, or words from the conversation. Put a phrase in quotation marks, or set exact, to match the words in that order. Deleted tickets do not appear. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| query string required | string | Ticket number, name, phone number with country code, email address, domain or keywords. |
| field enum | enum | subject, ticket_number or contact_email. Default: all fields. |
| exact boolean | boolean | Only match the words in that exact order. Default: false. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "trengo_read",
"arguments": {
"operation": "search_conversations",
"arguments": {
"query": "query"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversations": [
{
"conversation_id": 5119870,
"subject": "Where is my parcel?",
"contact": "Lena Vos",
"channel": "WhatsApp",
"labels": [
"Delivery"
],
"assigned_to": "Sam de Boer",
"last_message": {
"from": "team",
"preview": "It left our warehouse on Monday and arrives tomorrow.",
"at": "2026-10-14T13:20:00Z"
}
}
],
"next_cursor": null
},
"isError": false
}