- language:nodejs - sdk:relay - product:voice sidebar_custom_props: platform: javascript github: https://github.com/signalwire/examples/tree/main/Voice/Implement%20Coaching%20and%20Recording%20with%20NodeJS This guide will show you how to use Coaching and Recording features. Quickly learn how to implement conference controls that are the foundation of many call center dial flows. The [Coach](/compatibility-api/cxml/voice/conference-noun#coaching-a-conference-call) attribute accepts a call SID of a call that is currently connected to an in-progress conference. The application we will be building out examines an agent and a customer on a call, with a supervisor who later joins by coaching the conference. .default})
## Running the Application ### Build and Run on Docker 1. Use our pre-built image from Docker Hub docker pull signalwire/snippets-coaching:node (or build your own image) 1. Build your image docker build -t snippets-coaching . 2. Run your image docker run --publish 5000:5000 --env-file .env snippets-coaching 3. The application will run on port 5000 ### Build and Run Natively Lets set up your Node.js environment with Express to handle web requests. On the command line in your current directory, run the following command: To install Signalwire SDK via NPM (Node Package Manager) npm install @signalwire/compatibility-api To install express via NPM (Node Package Manager) npm install express To build your react components run npm run build To run the example, and start the express server run the following command. The server will run on port 5000, you can change the port in the code if you wish. node server.js You can now load the Dashboard by visiting your hostname on port 5000, and as you make calls they will appear on the Dashboard.
## Step by Step Code Walkthrough Within the github repo, you will find many files. The two that we will be looking into are: - example.env - server.js ### Setup Your Environment File 1. Copy from example.env and fill in your values 2. Save new file called .env Your file should look something like this # This is the full name of your SignalWire Space. e.g.: example.signalwire.com SIGNALWIRE_SPACE= # Your Project ID - you can find it on the API page in your Dashboard. SIGNALWIRE_PROJECT= # Your API token - you can generate one on the API page in your Dashboard SIGNALWIRE_TOKEN= # The phone number youll be using for this guide. Must include the +1, INBOUND_NUMBER= # The phone number youll be using for this guide. Must include the +1, AGENT_NUMBER= # The phone number youll be using for this guide. Must include the +1, SUPERVISOR_NUMBER= # Hostname, the IP address, or Fully Qualified Domain Name of your host and port, for routing action URLs HOSTNAME= ### server.js file When your Signalwire number receives an incoming voice call to the /inbound endpoint, Signalwire will dial the predefined agent phone number as specified in the environment file, and then once the agent is connected, will connect the supervisor to the call. Endpoint: /inbound Methods: GET OR POST This endpoint handles the incoming call and will spawn a call to an agent and a supervisor. javascript // Inbound Voice Endpoint app.get(/inbound, (req, res) => { console.log(req.query); var callSid = req.query.CallSid; // For demo store customer call sid in variable customerCallSid = callSid; CUSTOMER_NUMBER = req.query.From; // Connect Agent client.calls .create({ url: HOSTNAME + /connect_agent?conf_name= + CONF_NAME + &customerCallSid= + callSid, to: AGENT, from: INBOUND, }) .then((agentCall) => { console.log(agent); console.log(agentCall.sid); // For demo store agent call sid in variable agentCallSid = agentCall.sid; }); // Now that agent and supervisor have been requested, add the customer in var response = new VoiceResponse(); response = dial_conference( CONF_NAME, (coachSid = ), (muted = false), (startConferenceOnEnter = true), (endConferenceOnExit = true) ); res.writeHead(200, { Content-Type: text/xml, }); res.end(response.toString()); }); Now that we know how to connect the agent, customer and supervisor through coaching, we can enhance our call flow with more features such as recording manipulation, participant management other simple calling features. ### Web API Endpoints Below are all of the other included features to this call flow, look at whichever endpoints you need and you can find the javascript translations of each of these features in the [server.js](https://github.com/signalwire/guides/tree/main/Voice/Implement%20Coaching%20and%20Recording%20with%20NodeJS/server.js) file. // updates an in progress conference. /api/conferences/update // updates an in progress call /api/calls/update // entry for dashboard /api/dashboard // helper for demo that keeps track of caller role i.e. agent, supervisor, customer /api/helpers/lookupCaller // start recording /api/recordings/start // stop recording /api/recordings/stop // resume recording /api/recordings/resume // List recording for a call /api/recordings/list // Get Participants for call /api/participants
## Wrap Up Coaching can be a very useful tool for connecting and controlling in a conference call contexts. In this application, we built out a solution with an agent, a customer, and a supervisor to all converse in a single conference that is managed in real time. It is then not too tricky to incorporate more call features such as recording or muting into your conference experience, just like you would in any other calling context. Required Resources: - [SignalWires Node.js Relay SDK](https://docs.signalwire.com/topics/relay-sdk-nodejs/v2/#relay-sdk-for-node-js) - [SignalWIre Github Repo](https://github.com/signalwire/guides/tree/main/Voice/Implement%20Coaching%20and%20Recording%20with%20NodeJS) - [Express JS](https://expressjs.com) ## Sign Up Here If you would like to test this example out, [create a SignalWire account and Space](https://m.signalwire.com/signups/new?s=1). Please feel free to reach out to us on our [Community Slack](http://signalwire.community/) or create a Support ticket if you need guidance!