Skip to content

Get Tickets By Agent

Sayar Samanta edited this page Aug 28, 2018 · 2 revisions

Description : To fetch all tickets assigned to specific agent in FAVEO.

  1. URL : api/v1/helpdesk/my-tickets-agent

Parameters :

Name Data Type Required/Optional Description
token String Required token generated for a user
api_key String Optional An alphanumeric code that can be used to authenticate your API calls

HTTP Method : GET

Response Format : JSON

Response : Returns all the tickets assigned to specific agent in FAVEO.In case of any errors, an error message will be returned.

URL Request Example : http://www.stablehelpdeskc.faveodemo.com/api/v1/helpdesk/my-tickets-agent?api_key=9p41T2XFZ34YRZJUNQAdmM7iV0Rr1CjN&ip=null&token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOlwvXC9wcm9kdWN0ZGVtb3VybC5jb21cL2NvbW11bml0eVwvcHVibGljXC9hcGlcL3YxXC9hdXRoZW50aWNhdGUiLCJpYXQiOjE1MzUwMTQ5NzAsImV4cCI6MTUzNTAxNTIxMCwibmJmIjoxNTM1MDE0OTcwLCJqdGkiOiJLclBmbmtyUFJ0WjlUWW5jIiwic3ViIjoxLCJwcnYiOiI4N2UwYWYxZWY5ZmQxNTgxMmZkZWM5NzE1M2ExNGUwYjA0NzU0NmFhIn0.8Nnf9Q5lUQk1uLu_RseyHEWX_enNeZXZQ-d4WlHnXCs&user_id=1

JSON Response Example :

Success Response :

{
    "current_page": 1,
    "data": [
        {
            "priority_color": "#f39c11",
            "title": "Testing ticket with new SLA",
            "overdue_date": "2018-08-24 06:55:37",
            "attachment": 0,
            "updated_at": "2018-08-22 06:59:46",
            "user_name": "steve@gmail.com",
            "first_name": "steve",
            "last_name": "jobs",
            "email": "steve@gmail.com",
            "profile_pic": "https://secure.gravatar.com/avatar/97b691cbe6a457fe1de58da61d411e0a?s=80&r=g&d=identicon",
            "ticket_number": "AAAA-0000-0105",
            "id": 106,
            "created_at": "2018-08-22 06:55:37",
            "department_name": "Operation",
            "priotity_name": "High",
            "sla_plan_name": "sla 5",
            "help_topic_name": "Support query",
            "ticket_status_name": "Open"
        }
    ],
    "first_page_url": "http://productdemourl.com/community/public/api/v1/helpdesk/my-tickets-agent?page=1",
    "from": 1,
    "last_page": 1,
    "last_page_url": "http://productdemourl.com/community/public/api/v1/helpdesk/my-tickets-agent?page=1",
    "next_page_url": null,
    "path": "http://productdemourl.com/community/public/api/v1/helpdesk/my-tickets-agent",
    "per_page": 10,
    "prev_page_url": null,
    "to": 4,
    "total": 4
}


Some Common Error :

Error Response : If the token is expired

{
“error":"Token has expired"
}

If the token is not provided

 {
  "error": "token_not_provided"
}

If the agent id is not provided

{
    "error": {
        "user_id": [
            "The user id field is required."
        ]
    }
}

Response Description :

Parameter Description
updated_at indicates last updated time of the ticket
user_name user name of the user
first_name first name of the user
last_name last name of the user
email email of the user
profile_pic profile picture of the user
ticket_number ticket number
id id of the ticket
title title of the ticket
created_at ticket creation date
department_name department name of th ticket
priotity_name priority name of the ticket
priority_color priority color of the ticket
sla_plan_name sla plan of the ticket
help_topic_name help topic name of the ticket
ticket_status_name indicates ticket status name
overdue_date indicates ticket overdue date
first_page_url url of the first page
from indicates the first page
last_page indicates the last page
last_page_url url of the last page
next_page_url url of the next page
path path of the url
per_page number of tickets per page
prev_page_url url of the previous page
to number of total pages
total number of tickets

Installation and Upgrade Guide

Administrator's Guide

Agent's Guide

Email Integration

Release & Upgrade Notes

Known Issues

Contribute & Feedback

Knowledge Base

Third Party Integration

Plugins

API

Clone this wiki locally