Mosend
MosendDeveloper

Bot · Respuestas automáticas

Reglas automáticas: KEYWORD, OUT_OF_HOURS, WELCOME, FALLBACK con acciones.

Base path: /organizations/:orgId/bot/auto-replies·4 endpoints·Source: mosend-wb-backend/src/modules/bot/auto-replies/auto-replies.controller.ts
GET/organizations/:orgId/bot/auto-replies
bearer

Lista las respuestas automáticas del bot (filtrable por número).

Path params

  • orgIdstringrequerido

Query params

  • phoneNumberIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/auto-replies' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}
POST/organizations/:orgId/bot/auto-replies
bearer

Crea una respuesta automática del bot.

Path params

  • orgIdstringrequerido

Body (JSON)

  • namestringrequerido
  • triggerstringrequerido
    KEYWORDOUT_OF_HOURSWELCOMEFALLBACK
  • keywordMatchModestring
    EXACTCONTAINSSTARTS_WITHREGEX
  • keywordsstring[]
  • actionTypestringrequerido
    SEND_TEXTSEND_IMAGESEND_TEMPLATESTART_FLOWTRANSFER_TO_HUMAN
  • textBodystring
  • imageIdstring · uuid

    Imagen de la librería del bot, para actionType=SEND_IMAGE.

  • templateIdstring · uuid
  • flowIdstring · uuid
  • phoneNumberIdstring · uuid
  • prioritynumber
  • enabledboolean
  • cooldownSecondsnumber
  • renewAfterHoursnumber

    Ventana de renovación en horas (solo aplica a WELCOME / OUT_OF_HOURS). null = usar default del dispatcher; 0 = sin ventana (siempre dispara).

  • alsoHandoffboolean

    Si true, además de la acción marca la conv para asesor humano (handoff).

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/auto-replies' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"name": "<name>","trigger": "KEYWORD","keywordMatchMode": "EXACT","keywords": [],"actionType": "SEND_TEXT","textBody": "<textBody>","imageId": "00000000-0000-0000-0000-000000000000","templateId": "00000000-0000-0000-0000-000000000000","flowId": "00000000-0000-0000-0000-000000000000","phoneNumberId": "00000000-0000-0000-0000-000000000000","priority": 0,"enabled": true,"cooldownSeconds": 0,"renewAfterHours": 0,"alsoHandoff": true}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "trigger": "KEYWORD",
    "keyword": "precio",
    "action": "TEXT",
    "text": "Nuestros precios están en mosend.dev/precios"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
PATCH/organizations/:orgId/bot/auto-replies/:id
bearer

Actualiza una respuesta automática del bot.

Path params

  • orgIdstringrequerido
  • idstringrequerido

Body (JSON)

  • namestring
  • triggerstring
    KEYWORDOUT_OF_HOURSWELCOMEFALLBACK
  • keywordMatchModestring
    EXACTCONTAINSSTARTS_WITHREGEX
  • keywordsstring[]
  • actionTypestring
    SEND_TEXTSEND_IMAGESEND_TEMPLATESTART_FLOWTRANSFER_TO_HUMAN
  • textBodystring
  • imageIdstring · uuid

    Imagen de la librería del bot, para actionType=SEND_IMAGE.

  • templateIdstring · uuid
  • flowIdstring · uuid
  • phoneNumberIdstring · uuid
  • prioritynumber
  • enabledboolean
  • cooldownSecondsnumber
  • renewAfterHoursnumber

    Ventana de renovación en horas (solo aplica a WELCOME / OUT_OF_HOURS). null = usar default del dispatcher; 0 = sin ventana (siempre dispara).

  • alsoHandoffboolean

    Si true, además de la acción marca la conv para asesor humano (handoff).

Respuestas

  • 200
curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/auto-replies/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"name": "<name>","trigger": "KEYWORD","keywordMatchMode": "EXACT","keywords": [],"actionType": "SEND_TEXT","textBody": "<textBody>","imageId": "00000000-0000-0000-0000-000000000000","templateId": "00000000-0000-0000-0000-000000000000","flowId": "00000000-0000-0000-0000-000000000000","phoneNumberId": "00000000-0000-0000-0000-000000000000","priority": 0,"enabled": true,"cooldownSeconds": 0,"renewAfterHours": 0,"alsoHandoff": true}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "trigger": "KEYWORD",
    "keyword": "precio",
    "action": "TEXT",
    "text": "Nuestros precios están en mosend.dev/precios"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
DELETE/organizations/:orgId/bot/auto-replies/:id
bearer

Elimina una respuesta automática del bot.

Path params

  • orgIdstringrequerido
  • idstringrequerido

Respuestas

  • 204
curl -X DELETE 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/auto-replies/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}