MB SuiteMB Suite
Menú

Referencia de la API · CRM

Reenganche

crm · reengagement · 2 operaciones

GET/v1/crm/reengagementPOST/v1/crm/reengagement/dismiss
GET/v1/crm/reengagement

List deals or prospects that came back (re-engaged)

crm.reengagement.list

LecturaIdempotenteDesde 2026-11-01

Lists the deals or the prospects (entity) that came back: a contact with history wrote again, the CRM reopened (unarchived) the record or flagged the closed deal instead of creating a new one, and the banner is still waiting for a human decision (continue there, or create a new linked deal or prospect). Newest comeback first. Each row is a summary of the deal or prospect (title, status, owner with its name, pipeline and stage for a deal, person, company, value and currency) with what brought it back: reengaged_at, reengaged_from_status, reengaged_from_archived and reengaged_by_source (the channel of the message); the whole record comes with crm.deals.get or crm.prospects.get. Merged duplicates are left out; a seller with scope only gets what they can see. Paginated by cursor (limit up to 200). To continue with one, crm.reengagement.dismiss; creating a new linked deal or prospect is done in the app. With LinkedIn or TikTok, their terms limit it through the API and the MCP: what they do not allow answers 403 platform_terms_restricted, and their records are left out of the response (the permissions guide lists what each platform allows).

Alcance
crm:read
Permiso
Ver el módulo
Tool del MCP
crm_reengagement_listEn la superficie completa; en la compacta, mb_execute_operation con id: "crm.reengagement.list".

Costo declarado: hasta 202 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

entityenumqueryrequerido

deal or prospect: which records that came back.

Valores: deal, prospect

limitintegerqueryopcional

How many items this page brings at most (see the maximum and the default in the schema).

Por defecto: 50

cursorstringqueryopcional

The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.

Respuesta

dataarray<object>
has_moreboolean
next_cursorstring

Errores

invalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Ejemplo

curl "https://api.mb-suite.com/v1/crm/reengagement?entity=deal" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/crm/reengagement?entity=deal" \
  -H "Authorization: Bearer $MB_TEST_KEY"
POST/v1/crm/reengagement/dismiss

Continue with a re-engaged deal or prospect (resolve its comeback banner)

crm.reengagement.dismiss

EscrituraIdempotenteDesde 2026-11-01

Resolves the comeback banner of a re-engaged deal (deal_id) or prospect (prospect_id) by continuing with it, as «Continue here» in the app: the record's re-engaged mark goes off and the banner leaves every conversation that shows it for that record. Nothing else changes (owner, stage, history), and it no longer shows in crm.reengagement.list; creating a new linked deal or prospect instead is done in the app. Idempotent: if the banner is no longer there, nothing is written (changed false). It edits the record, so it needs edit_deal (with the deal's owner and pipeline) or edit_prospect (with its owner). 404 deal_not_found or prospect_not_found if the record does not exist, was merged or the caller cannot see it. Returns the record, changed and how many conversations were cleared.

Alcance
crm:write
Permiso
Editar en el módulo
Tool del MCP
crm_reengagement_dismissEn la superficie completa; en la compacta, mb_execute_operation con id: "crm.reengagement.dismiss".

Costo declarado: hasta 21 lecturas y 21 escrituras por llamada (cuentan en el cupo diario).

Parámetros

deal_idstringcuerpoopcional

The deal that came back (crm.reengagement.list with entity deal). Exactly one of deal_id and prospect_id.

prospect_idstringcuerpoopcional

The prospect that came back (crm.reengagement.list with entity prospect). Exactly one of deal_id and prospect_id.

Respuesta

entityobject
changedboolean

false when the banner was already gone (from the record and its conversations) and nothing was written.

conversations_clearednumber

How many conversations stopped showing the banner.

Errores

invalid_inputunknown_fieldauthentication_requiredscope_insufficientcrm_action_deniedidempotency_key_reusedrate_limitedquota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/crm/reengagement/dismiss" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X POST "https://api.mb-suite.com/v1/crm/reengagement/dismiss" \
  -H "Authorization: Bearer $MB_TEST_KEY"