codebar-ag / laravel-zendesk
Zendesk integration with Laravel
Requires
- php: ^8.2
- guzzlehttp/guzzle: ^7.8
- illuminate/contracts: ^10.0
- laravel/framework: ^10.28
- orchestra/testbench: ^8.13
- saloonphp/cache-plugin: ^3.0
- saloonphp/laravel-plugin: ^3.0
- saloonphp/saloon: ^3.0
- spatie/laravel-data: ^3.9
- spatie/laravel-package-tools: ^1.16
Requires (Dev)
- laravel/pint: ^1.13
- nunomaduro/collision: ^7.10
- nunomaduro/larastan: ^2.6
- orchestra/testbench: ^8.13
- pestphp/pest: ^2.23
- pestphp/pest-plugin-laravel: ^2.2
- phpstan/extension-installer: ^1.3
- phpstan/phpstan-deprecation-rules: ^1.1
- phpstan/phpstan-phpunit: ^1.3
- spatie/laravel-ray: ^1.33
README
This package was developed to give you a quick start to creating tickets via the Zendesk API.
π‘ What is Zendesk?
Zendesk is a cloud-based help desk management solution offering customizable tools to build customer service portals, knowledge base and online communities.
π Requirements
Authentication
The currently supported authentication methods are:
βοΈ Installation
You can install the package via composer:
composer require codebar-ag/laravel-zendesk
Optionally, you can publish the config file with:
php artisan vendor:publish --provider="CodebarAg\Zendesk\ZendeskServiceProvider" --tag="config"
You can add the following env variables to your .env
file:
ZENDESK_SUBDOMAIN=your-subdomain #required ZENDESK_AUTHENTICATION_METHOD=token #default ['basic', 'token'] ZENDESK_EMAIL_ADDRESS=test@example.com #required ZENDESK_API_TOKEN=your-api-token #required only for token authentication ZENDESK_API_PASSWORD=your-password #required only for basic authentication
Note: We handle base64 encoding for you so you don't have to encode your credentials.
You can retrieve your API token from your Zendesk Dashboard
Usage
To use the package, you need to create a ZendeskConnector instance.
use CodebarAg\Zendesk\ZendeskConnector; ... $connector = new ZendeskConnector();
Requests
The following requests are currently supported:
Responses
The following responses are currently supported for retrieving the response body:
See https://docs.saloon.dev/the-basics/responses for more information.
Enums
We provide enums for the following values:
Note: When using the dto method on a response, the enum values will be converted to their respective enum class.
DTOs
We provide DTOs for the following:
Note: This is the prefered method of interfacing with Requests and Responses however you can still use the json, object and collect methods. and pass arrays to the requests.
Examples
Create a ticket
use CodebarAg\Zendesk\Requests\CreateSingleTicketRequest; use CodebarAg\Zendesk\DTOs\SingleTicketDTO; use CodebarAg\Zendesk\DTOs\CommentDTO; use CodebarAg\Zendesk\Enums\TicketPriority; ... $ticketResponse = $connector->send( new CreateSingleTicketRequest( SingleTicketDTO::fromArray([ 'comment' => CommentDTO::fromArray([ 'body' => 'The smoke is very colorful.', ]), 'priority' => TicketPriority::URGENT, "subject" => "My printer is on fire!", "custom_fields" => [ [ "id" => 12345678910111, "value" => "Your custom field value" ], [ "id" => 12345678910112, "value" => "Your custom field value 2" ], ], ]) ) ); $ticket = $ticketResponse->dto();
List all tickets
use CodebarAg\Zendesk\Requests\AllTicketsRequest; ... $listTicketResponse = $connector->send(new AllTicketsRequest()); $listTicketResponse->dto();
Count all tickets
use CodebarAg\Zendesk\Requests\CountTicketsRequest; ... $countTicketResponse = $connector->send(new CountTicketsRequest()); $countTicketResponse->dto();
Show a ticket
use CodebarAg\Zendesk\Requests\ShowTicketRequest; ... $ticketID = 1; $showTicketResponse = $connector->send(new ShowTicketRequest($ticketID)); $showTicketResponse->dto();
Upload an attachment
use CodebarAg\Zendesk\Requests\CreateAttachmentRequest; use CodebarAg\Zendesk\Requests\CreateSingleTicketRequest; use Illuminate\Support\Facades\Storage; $uploadResponse = $connector->send( new CreateAttachmentRequest( fileName: 'someimage.png', mimeType: Storage::disk('local')->mimeType('public/someimage.png'), stream: Storage::disk('local')->readStream('public/someimage.png') ) ); $token = $uploadResponse->dto()->token; $ticketResponse = $connector->send( new CreateSingleTicketRequest( SingleTicketDTO::fromArray([ 'comment' => CommentDTO::fromArray([ ... 'uploads' => [ $token, ], ]), ]) ) ); $ticket = $ticketResponse->dto();
π§ Testing
Copy your own phpunit.xml-file.
cp phpunit.xml.dist phpunit.xml
Run the tests:
./vendor/bin/pest
π Changelog
Please see CHANGELOG for recent changes.
βοΈ Contributing
Please see CONTRIBUTING for details.
composer test
Code Style
./vendor/bin/pint
π§βπ» Security Vulnerabilities
Please review our security policy on reporting security vulnerabilities.
π Credits
- Rhys Lees
- Sebastian Fix
- All Contributors
- Skeleton Repository from Spatie
- Laravel Package Training from Spatie
- Laravel Saloon by Sam CarrΓ©
π License
The MIT License (MIT). Please have a look at License File for more information.