livechat/api-client-php

Enables PHP applications to communicate with the LiveChat API.

LiveChat API Client

PHP client for connecting to the LiveChat REST API., _(*1)

Documentation

To find out more, visit the official LiveChat REST API documentation., _(*2)

Previous version of LiveChat API Client., _(*3)

Requirements

• PHP 5.3 or greater
• cUrl extension enabled

Authentication to the API occurs via HTTP Basic Auth. Provide your:, _(*4)

• login
• API key

More information: https://developers.livechatinc.com/rest-api/#authentication, _(*5)

Installation

Composer, _(*6)

$ composer require livechat/api-client-php "@dev"

Or, set up dev as minimum-stability in your composer.json:, _(*7)

    "minimum-stability": "dev"

Then:, _(*8)

 $ composer require livechat/api-client-php
 $ composer update

Execute tests

This operation requires PHPUnit installed., _(*9)

 $ phpunit

Basic usage

<?php

require_once __DIR__ . '/vendor/autoload.php';

use LiveChat\Api\Client as LiveChat;

$LiveChatAPI = new LiveChat('%login%', '%apiKey%');
$agents = $LiveChatAPI->agents->get();

Available methods

Methods returns stdClass (parsed JSON response)., _(*10)

Agents

Agents REST API documentation., _(*11)

• $LiveChatAPI->agents->get($login = null)
• $LiveChatAPI->agents->add(array $vars)
• $LiveChatAPI->agents->update($login, array $vars)
• $LiveChatAPI->agents->delete($login)

Canned responses

Canned responses REST API documentation., _(*12)

• $LiveChatAPI->cannedResponses->get($group = 0)
• $LiveChatAPI->cannedResponses->getSingleResponse($id)
• $LiveChatAPI->cannedResponses->addNewResponse($text, $tags)
• $LiveChatAPI->cannedResponses->updateResponse($id, $text, $tags)
• $LiveChatAPI->cannedResponses->deleteResponse($id)

Chat archives

Archives REST API documentation., _(*13)

• $LiveChatAPI->chats->get($params = array())
• $LiveChatAPI->chats->getSingleChat($chatId)
• $LiveChatAPI->chats->updateTags($id, array $vars)

Goals

Goals REST API documentation., _(*14)

• $LiveChatAPI->goals->markAsSuccessful($goalId)

Groups

Groups REST API documentation., _(*15)

• $LiveChatAPI->groups->get($group = 0)
• $LiveChatAPI->groups->update($id, array $vars)
• $LiveChatAPI->groups->add(array $vars)
• $LiveChatAPI->groups->delete($id)

Reports

Reports REST API documentation., _(*16)

• $LiveChatAPI->reports->get($type, array $params = array())

Status

Status REST API documentation., _(*17)

• $LiveChatAPI->status->get($group = 0)

Tickets

Tickets REST API documentation., _(*18)

• $LiveChatAPI->tickets->get(array $params = array())
• $LiveChatAPI->tickets->getSingleTicket($ticketId)
• $LiveChatAPI->tickets->add(array $vars)
• $LiveChatAPI->tickets->updateTags($id, array $vars)

Visitors

Visitors REST API documentation., _(*19)

• $LiveChatAPI->visitors->get(array $params = array())

Webhooks

Webhooks REST API documentation., _(*20)

• $LiveChatAPI->webhooks->get(), _(*21)

• $LiveChatAPI->webhooks->add(array( "event_type" => "chat_started", "data_types" => array( "chat", "visitor" ), "url" => "http://www.shoeshop.com/webhook", )), _(*22)

• $LiveChatAPI->webhooks->delete('622d3950eecea8bb5f8c26f20c76ee2e'), _(*23)

To do

• Tests for models
• Add all supported API methods