DocumentacionChatbot Botpress y helpdesk 24/7

Chatbot Botpress y helpdesk 24/7

Enviar correos transaccionales al abrir incidencias desde un flujo Botpress de atencion al cliente.

Muchos equipos de soporte usan Botpress como canal de atencion al cliente fuera del horario de oficina. Cuando el usuario completa un flujo de incidencia (codigo de maquina, ubicacion, descripcion), el bot debe notificar al helpdesk por email de forma fiable — incluso a las 3 de la manana.

MailingCore encaja como capa de envio transaccional: cola asincrona, plantillas versionadas, dominio verificado y trazabilidad en logs.

Flujo tipico

Que debe hacer el bot

Validar campos minimos (email de contacto, tipo de incidencia, descripcion).
Llamar al backend — nunca exponer la API key en el widget del navegador; usa una accion Botpress server-side o un microservicio (por ejemplo botpress-service) que tenga la clave en variables de entorno.
Enviar con POST /emails/send y metadata para correlacionar ticket e conversacion.
Confirmar al usuario en el chat (mensaje del bot) solo tras respuesta exitosa de la API.

Ejemplo de envio

curl -X POST "https://api.mailingcore.com/emails/send" \
  -H "Authorization: Bearer mc_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "[email protected]",
    "subject": "[Incidencia] Codigo 5859 — C.C. Albacenter",
    "htmlBody": "<h2>Nueva incidencia desde chatbot</h2><p>Codigo: 5859</p><p>Ubicacion: C.C. Albacenter</p><p>Contacto: [email protected]</p>",
    "replyTo": "[email protected]",
    "fromEmail": "[email protected]",
    "fromName": "Asistente virtual",
    "tags": ["botpress", "helpdesk", "incidencia"],
    "metadata": {
      "source": "botpress",
      "conversationId": "conv_abc123",
      "incidentCode": "5859",
      "locale": "es"
    },
    "idempotencyKey": "botpress-conv_abc123-incident"
  }'

Campo	Uso en helpdesk
`metadata.conversationId`	Enlazar con el hilo en Botpress / inbox operador
`metadata.incidentCode`	Codigo de maquina o referencia interna
`replyTo`	Responder directamente al cliente
`idempotencyKey`	Evitar duplicados si el usuario reintenta el flujo
`tags`	Filtrar en logs de envio

Opcional: publica una plantilla en el panel y envia con templateVersionId en lugar de htmlBody fijo.

Plantilla y tono al usuario

Tras el envio, el bot suele mostrar un mensaje de cierre, por ejemplo:

He registrado tu incidencia correctamente. El equipo tecnico se pondra en contacto en un maximo de 24 horas habiles.

Ese texto es solo UX en el chat; el email al helpdesk lleva el detalle operativo. Si usas un inbox de conversaciones (sync Botpress + deteccion de envio), puedes marcar email_sent_detected cuando el bot confirma el registro.

Requisitos operativos

Requisito	Detalle
API key	Scope `email:send` minimo
Dominio	Verificar remitente (`fromEmail`)
Cuota	Cada incidencia cuenta en la cuota mensual — monitoriza `X-Quota-*`
Disponibilidad	La cola BullMQ acepta peticiones 24/7; no necesitas SMTP propio despierto

Errores frecuentes

401 / 403 — API key revocada o sin scope; revisa API keys.
429 — Cuota superada; planes y upgrade.
Duplicados — Falta idempotencyKey por conversacion.
Key en el cliente — Mover la llamada a servidor; ver Seguridad de API keys.

Siguientes pasos

Inicio rapido — primer envio
Enviar con el SDK — si el puente es Node.js
Webhooks — notificar a tu CRM cuando email.sent o email.bounced