Skip to content

Create Ticket

Sayar Samanta edited this page Aug 24, 2018 · 6 revisions

Description : To create a ticket in faveo HELPDESK

  1. URL: api/v1/helpdesk/create

Parameters :

Name Data Type Required/Optional Description
api_key String Optional An alphanumeric code that can be used to authenticate your API calls. To make it required login to Admin panel and go to API setting and make it mandatory
user_id String Optional id of the user
subject String Required Subject of the ticket
body String Required Body of the ticket
helptopic String Required Help topic of the ticket
sla String Required Sla of the ticket
dept String Optional id of the department
token String Required token generated for a user
first_name String Required First name of the requester
last_name String Required Last name of the requester
phone String Optional Phone number of the requester
code String Required if phone is not null, else optional country code of the requestor
mobile String Optional mobile number of the requester
duedate String Optional Due date for the ticket
email String Required Email of the requester

HTTP Method : POST

Response Format : JSON

Response : Returns the success response after the ticket has been creaetd

URL Request Example : http://productdemourl.com/community/public/api/v1/helpdesk/create?subject=test ticket&body=test demo ticket&helptopic=1&sla=1&priority=1&token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOlwvXC9wcm9kdWN0ZGVtb3VybC5jb21cL2NvbW11bml0eVwvcHVibGljXC9hcGlcL3YxXC9hdXRoZW50aWNhdGUiLCJpYXQiOjE1MzUwMDk0MjIsImV4cCI6MTUzNTAwOTY2MiwibmJmIjoxNTM1MDA5NDIyLCJqdGkiOiJScU5IdExHRTM3Wmk4NnF4Iiwic3ViIjoxLCJwcnYiOiI4N2UwYWYxZWY5ZmQxNTgxMmZkZWM5NzE1M2ExNGUwYjA0NzU0NmFhIn0.0ZrpyuzhtSZh3yS7j4F4fRRTt7CksCDAqize_dxPwvQ&first_name=demo&last_name=user&email=user@gmail.com&phone=123456789&code=91

JSON Response Example :

Success Response :

{
    "response": {
        "ticket_id": 114,
        "message": "Ticket created successfully!"
    }
}

Some Common Error :

Error Response : If the token is expired

{
“error":"Token has expired"
}

If any required field is missing

{
    "success": false,
    "errors": {
        "first_name": [
            "The first name field is required."
        ]
    }
}

If country code not provided while mobile number is provided

{
    "response": {
        "fails": "Code is required with phone/mobile number.",
        "phonecode": 91,
        "country_code_error": 1
    }
}

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