simpla.fydocs
Seguros APIseguros-api reference

List SDR contacts with data cross-referencing

Returns paginated list of unique contacts (grouped by session_id) with LEFT JOIN to Person and Sell tables for data enrichment. Includes aggregated metrics: totalContacts, activeContacts, conversionRate, totalMessages.

GET
/sdr/contacts

Returns paginated list of unique contacts (grouped by session_id) with LEFT JOIN to Person and Sell tables for data enrichment. Includes aggregated metrics: totalContacts, activeContacts, conversionRate, totalMessages.

Authorization

x-api-key<token>

In: header

Query Parameters

page?number

Page number

Default1
Range1 <= value
limit?number

Items per page

Default20
Range1 <= value <= 100
search?string

Search by partial phone number

status?string

Filter by activity status (active: last_interaction < 30 days)

Value in"active" | "inactive" | "all"
registered?string

Filter by registered status (has Person record)

Value in"true" | "false" | "all"
dateFrom?string

Filter by start date (last_interaction >= dateFrom)

dateTo?string

Filter by end date (last_interaction <= dateTo)

qualified?string

Filter by qualified status (has sales)

Default"all"
Value in"true" | "false" | "all"
sortBy?string

Column to sort by

sortOrder?string

Sort order

Value in"asc" | "desc"
converted?string

Filter by converted status (has sales) - deprecated, use qualified

Default"all"
Value in"true" | "false" | "all"

Response Body

application/json

curl -X GET "https://example.com/sdr/contacts"
{
  "data": [
    []
  ],
  "total": 50,
  "page": 1,
  "limit": 20,
  "hasMore": true,
  "metrics": {
    "totalContacts": 150,
    "conversionRate": 0.34,
    "totalMessages": 2340,
    "sdrDisparos": 120,
    "sdrConvertidos": 45,
    "sdrTaxaConversao": 37.5
  }
}
Empty
Empty

List messages for a chat

Returns paginated list of WhatsApp messages from Evolution API for a specific instance and remote JID

Get client info by session ID

Returns client information by session ID with LEFT JOIN to Person and Sell tables. Includes phone extraction, status calculation, and sales aggregation. Returns fallback values when person not found.