{"id":4359,"date":"2024-10-28T08:30:00","date_gmt":"2024-10-28T07:30:00","guid":{"rendered":"https:\/\/www.beevoip.it\/blog\/?p=4359"},"modified":"2024-10-20T13:26:42","modified_gmt":"2024-10-20T11:26:42","slug":"risponditore-virtuale-integrare-ai4call-con-il-tuo-sistema-di-ticket-una-guida-pratica","status":"publish","type":"post","link":"https:\/\/www.beevoip.it\/blog\/risponditore-virtuale-integrare-ai4call-con-il-tuo-sistema-di-ticket-una-guida-pratica\/","title":{"rendered":"Integrare AI4Call con il tuo sistema di Ticket: una guida pratica"},"content":{"rendered":"\n
\n

Se hai gi\u00e0 un sistema di ticket con accesso alle API o al database e desideri integrarlo con le telefonate, AI4Call offre una soluzione flessibile e potente. In questo post, esploreremo come implementare questa integrazione con un esempio di codice dettagliato e commentato.<\/p>\n\n

Panoramica del Processo<\/h2>\n \n
    \n
  1. La chiamata viene inoltrata ad AI4Call<\/li>\n
  2. AI4Call si collega al tuo server API<\/li>\n
  3. Il tuo server gestisce la chiamata in base alle tue esigenze specifiche<\/li>\n <\/ol>\n\n

    Implementazione<\/h2>\n \n

    Ecco un esempio di codice Node.js che illustra come potresti implementare questa integrazione:<\/p>\n\n 

    \n    \nconst express = require('express');\nconst bodyParser = require('body-parser');\nconst axios = require('axios');\n\nconst app = express();\napp.use(bodyParser.json());\n\n\/\/ Simula un database di ticket\nconst ticketDB = {\n    \/\/ ... (aggiungi qui i tuoi ticket di esempio)\n};\n\n\/\/ Endpoint iniziale chiamato da AI4Call\napp.post('\/incoming-call', async (req, res) => {\n    const { callerNumber } = req.body;\n\n    \/\/ Identifica il chiamante e cerca ticket associati\n    const caller = await identifyCaller(callerNumber);\n    const tickets = await getTicketsForCaller(caller.id);\n\n    if (tickets.length > 0) {\n        \/\/ Se ci sono ticket esistenti, offri opzioni\n        res.json({\n            text: `Benvenuto ${caller.name}. Hai ${tickets.length} ticket aperti. Digita 1 per controllare lo stato, 2 per aggiornarne uno, o 3 per aprirne uno nuovo.`,\n            action: \"ASR_DTMF\",\n            key: \"choice\",\n            next_url: \"https:\/\/your-server.com\/handle-ticket-choice\",\n            min_length: 1,\n            max_length: 1\n        });\n    } else {\n        \/\/ Se non ci sono ticket, vai direttamente alla creazione\n        res.json({\n            text: `Benvenuto ${caller.name}. Non hai ticket aperti. Creiamone uno nuovo. Quale \u00e8 l'oggetto del tuo problema?`,\n            action: \"ASR_string\",\n            key: \"ticketSubject\",\n            next_url: \"https:\/\/your-server.com\/create-ticket\"\n        });\n    }\n});\n\n\/\/ Gestisce la scelta dell'utente per i ticket esistenti\napp.post('\/handle-ticket-choice', async (req, res) => {\n    const { choice, callerNumber } = req.body;\n    const caller = await identifyCaller(callerNumber);\n    const tickets = await getTicketsForCaller(caller.id);\n\n    switch(choice) {\n        case \"1\":\n            \/\/ Controlla lo stato del ticket\n            const latestTicket = tickets[0];\n            res.json({\n                text: `Il tuo ultimo ticket riguarda \"${latestTicket.subject}\" ed \u00e8 attualmente ${latestTicket.status}. Vuoi ulteriori dettagli? Digita 1 per s\u00ec, 2 per no.`,\n                action: \"ASR_DTMF\",\n                key: \"moreDetails\",\n                next_url: \"https:\/\/your-server.com\/ticket-details\"\n            });\n            break;\n        case \"2\":\n            \/\/ Aggiorna un ticket esistente\n            res.json({\n                text: `Quale ticket vuoi aggiornare? Digita il numero corrispondente.`,\n                action: \"ASR_DTMF\",\n                key: \"ticketToUpdate\",\n                next_url: \"https:\/\/your-server.com\/update-ticket\",\n                min_length: 1,\n                max_length: tickets.length.toString().length\n            });\n            break;\n        case \"3\":\n            \/\/ Crea un nuovo ticket\n            res.json({\n                text: `Creiamo un nuovo ticket. Quale \u00e8 l'oggetto del tuo problema?`,\n                action: \"ASR_string\",\n                key: \"ticketSubject\",\n                next_url: \"https:\/\/your-server.com\/create-ticket\"\n            });\n            break;\n        default:\n            res.json({\n                text: \"Scelta non valida. Per favore, riprova.\",\n                action: \"ASR_DTMF\",\n                key: \"choice\",\n                next_url: \"https:\/\/your-server.com\/handle-ticket-choice\",\n                min_length: 1,\n                max_length: 1\n            });\n    }\n});\n\n\/\/ Crea un nuovo ticket\napp.post('\/create-ticket', async (req, res) => {\n    const { ticketSubject, callerNumber } = req.body;\n    const caller = await identifyCaller(callerNumber);\n\n    \/\/ Qui andresti a creare effettivamente il ticket nel tuo sistema\n    const newTicket = await createTicketInSystem(caller.id, ticketSubject);\n\n    res.json({\n        text: `Grazie. Ho creato un nuovo ticket con oggetto \"${ticketSubject}\". Il numero del tuo ticket \u00e8 ${newTicket.id}. Un nostro operatore ti contatter\u00e0 presto. C'\u00e8 altro in cui posso aiutarti?`,\n        action: \"ASR_DTMF\",\n        key: \"moreHelp\",\n        next_url: \"https:\/\/your-server.com\/more-help\",\n        min_length: 1,\n        max_length: 1\n    });\n});\n\n\/\/ Funzioni di supporto (da implementare con la tua logica specifica)\nasync function identifyCaller(phoneNumber) {\n    \/\/ Implementa la logica per identificare il chiamante dal numero di telefono\n}\n\nasync function getTicketsForCaller(callerId) {\n    \/\/ Implementa la logica per ottenere i ticket associati al chiamante\n}\n\nasync function createTicketInSystem(callerId, subject) {\n    \/\/ Implementa la logica per creare un nuovo ticket nel tuo sistema\n}\n\napp.listen(3000, () => console.log('Server running on port 3000'));\n    <\/code>\n  <\/pre>\n\n  
    Spiegazione del Codice<\/h2>\n  \n  
    Questo codice implementa un server Express che gestisce le chiamate inoltrate da AI4Call. Ecco i punti chiave:<\/p>\n\n