DocumentazioneChatbot Botpress e helpdesk 24/7

Chatbot Botpress e helpdesk 24/7

Inviare email transazionali aprendo un'incidenza helpdesk da un flusso Botpress di assistenza clienti.

Molti team di supporto usano Botpress per l'assistenza clienti fuori dall'orario d'ufficio. Quando l'utente completa un flusso di incidenza (codice macchina, sede, descrizione), il bot deve notificare l'helpdesk via email in modo affidabile — anche alle 3 di notte.

MailingCore funge da layer di invio transazionale: coda asincrona, template versionati, dominio verificato e log di consegna.

Flusso tipico

Cosa deve fare il bot

Validare i campi minimi (email contatto, tipo incidenza, descrizione).
Chiamare il backend — non esporre la API key nel widget; usa un'azione server-side Botpress o un microservizio (es. botpress-service) con variabili d'ambiente.
Inviare con POST /emails/send e metadata per correlare ticket e conversazione.
Confermare in chat solo dopo risposta API riuscita.

Esempio di invio

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": "[Incidenza] Codice 5859 — Centro Albacenter",
    "htmlBody": "<h2>Nuova incidenza da chatbot</h2><p>Codice: 5859</p><p>Sede: Centro Albacenter</p><p>Contatto: [email protected]</p>",
    "replyTo": "[email protected]",
    "fromEmail": "[email protected]",
    "fromName": "Assistente virtuale",
    "tags": ["botpress", "helpdesk", "incidenza"],
    "metadata": {
      "source": "botpress",
      "conversationId": "conv_abc123",
      "incidentCode": "5859",
      "locale": "it"
    },
    "idempotencyKey": "botpress-conv_abc123-incident"
  }'

Campo	Uso helpdesk
`metadata.conversationId`	Collegamento al thread Botpress / inbox operatore
`metadata.incidentCode`	Codice macchina o riferimento interno
`replyTo`	Rispondere direttamente al cliente
`idempotencyKey`	Evitare duplicati se l'utente riprova
`tags`	Filtrare nei log

Opzionale: template pubblicato nel pannello e invio con templateVersionId.

Messaggio all'utente

Dopo l'invio, il bot mostra tipicamente:

Ho registrato la tua incidenza correttamente. Il team tecnico ti contattera entro 24 ore lavorative.

Solo UX in chat; l'email all'helpdesk contiene il dettaglio operativo.

Requisiti operativi