Skip to content

Latest commit

 

History

History
52 lines (34 loc) · 3.89 KB

README.md

File metadata and controls

52 lines (34 loc) · 3.89 KB
Raw

Full Stack Challenge

You're applying to either a Back-end or Full Stack developer position at Teravoz, and in this step we'll require you to accomplish at least one of the four tasks listed below.

Here we're trying to assess the following skills:

  • Understanding and solving of a given problem
  • Comprehensible code writing and organization
  • Knowledge of JavaScript
  • Use of Node.js runtime and its libraries
  • Intelligible and useful documentation writing, like READMEs and code comments
  • Development practices like automated tests
  • Comprehensible English writing

You can submit answers on a GitHub repository or gist, or by email if you require privacy or confidentiality. We'd like all documentation to be written in English, but if you're uncomfortable with it, it's OK to be in Portuguese.

Tasks

1. Proud of

Share a little piece of code or even an entire application, in any programming language, that you developed and you're proud of, telling us why.

2. Ashamed of

Share a little piece of code or even an entire application, in any programming language, that you developed or saw and you're ashamed of (or secondhand embarrassed for), telling us why.

3. Write a client for integrating with Teravoz API

Let's suppose you're a developer working for a company with a call center operation. There's a receptionist who handles calls and transfers them following some rules:

  • first, receptionist answers and asks customer's phone number
  • then, searches customer on company's contacts list system
  • if not found, registers customer number into contacts list, and then transfers call to extension 900, which is a call center queue for handling first contact customers. Receptionist does this by dialing *2900 on the phone
  • if found, transfers call to extension 901, which is a call center queue for handling returning customers. Receptionist does this by dialing *2901 on the phone

Such operation is expensive, error-prone and takes a lot of time for a customer to be answered. Your company already uses Teravoz as call center platform provider, meaning that all incoming and outgoing calls goes through Teravoz systems. After reading documentation on https://developers.teravoz.com.br, you noticed a feature called delegate that you could use for automating your call center operation. So you decided to integrate your company's system with Teravoz API, by replacing receptionist's manual steps like asking customer's phone number by listening to events on a webhook, and deciding which queue to transfer calls by making POST requests to /actions endpoint.

So your Node.js application has to do the following:

  • Listen to events emitted by Teravoz at /webhook endpoint. Events are and come in the following order: call.new, call.standby, call.waiting, actor.entered, call.ongoing, actor.left, call.finished. Those are life cycle events of a call
  • When an event of type call.standby arrives, you need to delegate that call based on the given criteria above, by POSTing to Teravoz API's /actions endpoint
  • When app is restarted, it needs to work as if it hasn't at all - returning customers will always be returning customers

Also, for full stackers:

  • use of Docker containers
  • a little dashboard in React or other library, showing current active calls

Unfortunately, Teravoz doesn't have a sandbox environment which you could use for interacting with, so you need to mock the required interaction between your application and Teravoz API. For example, you need to simulate POSTs to your /webhook endpoint.

We're expecting your application to be fully operational and well documented. You don't need to use a database, a plain-text file shall do the job. You can use any library you want.

4. Give us feedback

What do you think about this challenge? Is this a nice and reliable way of assessing your skills? Would you think of another way? Would you make it better?