HappHapp Docs
Messages

Search messages by text

GET
/api/messages/search

Substring search over message text within the caller's company scope, backed by a pg_trgm GIN index. System messages and function-call frames are excluded. Cursor-paginated by createdAt DESC.

Authorization

access-token
X-Access-Token<token>

Enter your Access Token (format: happ_...)

In: header

Query Parameters

q*string

Search query (3..100 chars)

companyId?string

Restrict to a specific company (must be in access-token scope)

chatId?string

Restrict to a specific chat

messenger?string

Value in

  • "instagram"
  • "telegram"
  • "telegram-bot"
  • "messenger"
  • "whatsapp"
  • "whatsapp-business"
  • "viber-echat"
  • "custom-messenger"
  • "widget"
  • "playground"
cursor?string

Opaque cursor from previous response

limit?number

Page size (1..100)

Default20

Response Body

curl -X GET "https://example.com/api/messages/search?q=string"
Empty
Empty