Smiley

Smileys are the feedback from people who have contacted a reception.

After the call or chat has ended, the caller will receive an SMS or email asking for feedback on how the conversation went. This feedback is called a smiley.

1. Properties
2. Get smileys
3. Get smiley statistics

Smiley properties

{"id":1}

{"conversation_type":"chat"}

{"conversation_type":"call"}

{"conversation_uuid":"218ec3b2-6403-11e7-2bbf-9da5cece18a5"}

{"rated_at":"2014-11-12T16:14:33+01:00"}

{"sort_value":"2014-11-12T16:14:33+01:00"}

{"rating":1}

{"net_promoter_score":0}

{"net_promoter_score":5}

{"net_promoter_score":8}

{"net_promoter_score":10}

{"kind":"negative"}

{"comment":"Very nice people."}

{"comment":null}

{"number":"4571999999"}

{"number_formatted":"71 99 99 99"}

{"email":"peter@example.com"}

{"contact":{"id":1,"name":"Relatel A/S","number":"4571999999","number_formatted":"71 99 99 99","email":"kundeservice@relatel.dk"}}

{"endpoint":"Reception#2"}

{"endpoint":"ChatReception#3"}

{"reception_id":4}

{"employee_id":432}

{"call_recording":{"id":234,"started_at":"2014-11-12T16:10:02+01:00","duration":101,"sound":{"formats":["audio/mpeg"],"url":"https://app.relatel.dk/api/v2/call_recordings/234/sound"}}}

Get smileys

Get smileys. Filter with these parameters.

The paramters are all optional, and can be mixed and matched.

For example; give me all smileys given to Employee with ID 55, that are “happy” and have a comment.

GET /api/v2/smileys

Response

Status: 200 OK

{
  "smileys": [
    {
      "id": 2,
      "call_uuid": "218ec3b2-6403-11e7-2bbf-9da5cece18a5",
      "conversation_type": "call",
      "conversation_uuid": "218ec3b2-6403-11e7-2bbf-9da5cece18a5",
      "rated_at": "2014-11-12T16:14:33+01:00",
      "sort_value": "2014-11-12T16:14:33+01:00",
      "rating": 1,
      "net_promoter_score": 9,
      "kind": "positive",
      "comment": "A nice experience.",
      "number": "4571999999",
      "emoji": "👍",
      "number_formatted": "71 99 99 99",
      "email": null,
      "contact": {
        "id": 3277849,
        "number": "4571999999",
        "number_formatted": "71 99 99 99",
        "name": "John Doe",
        "email": "doe@example.com"
      },
      "employee_id": 123,
      "endpoint": "Reception#2",
      "reception_id": 2,
      "call_recording": {
        "id": 234,
        "started_at": "2014-11-12T16:10:02+01:00",
        "duration": 101,
        "sound": {
          "formats": [
            "audio/mpeg"
          ],
          "url": "https://app.relatel.dk/api/v2/call_recordings/234/sound"
        }
      }
    }
  ]
}

Get smiley statistics

Get statistics for a given period.

URL parameters

Response properties

{"smiley_requests_count":10}

{"smileys_count":4}

{"positive_smileys_count":2}

{"negative_smileys_count":2}

{"commented_smileys_count":4}

{"average_rating":0.75}

GET /api/v2/smileys/statistics?from_time=:from_time&to_time=:to_time

Response

Status: 200 OK

{
  "statistics": {
    "receptions": [
      {
        "id": 2,
        "endpoint": "Reception#2",
        "smileys_count": 40,
        "positive_smileys_count": 38,
        "negative_smileys_count": 2,
        "commented_smileys_count": 20,
        "smiley_requests_count": 100,
        "average_rating": 0.95,
        "employees": [
          {
            "id": 441,
            "average_rating": 0.95,
            "smileys_count": 40,
            "positive_smileys_count": 38,
            "negative_smileys_count": 2,
            "commented_smileys_count": 20
          }
        ]
      }
    ]
  }
}