mediumart/intercom

Intercom API [Macroable] client adapter for laravel

Mediumart Intercom

, _(*1)

Mediumart Intercom Client is macroable !, _(*2)

Installation

To install, first require the package via composer:, _(*3)

$ composer require mediumart/intercom

Next add the following to your config/app.php inside the 'providers' array:, _(*4)

Mediumart\Intercom\IntercomServiceProvider::class

and the facade reference inside the 'aliases' array:, _(*5)

'Intercom' => Mediumart\Intercom\Intercom::class

Configuration

You need to create an app with an associated access_token from your intercom.io account. You can find informations on how to do that here., _(*6)

Once you got your access token, open the config/services.php in your laravel project and add a key for the intercom service like this:, _(*7)

'intercom' => [
    'access_token' => '<your_access_token>'
]

The package will automatically pick out the token to authenticate any api request to your own intercom data., _(*8)

Usage

You can resolve the intercom Client in many ways:, _(*9)

use Mediumart\Intercom\Client;

/** 
* Manually resolving from the container 
* */
$intercom = app('intercom');
// or
$intercom = app(Client::class);


/** 
* using type hinting and laravel's automatic resolution
* */
public function index(Client $intercom) 
{
    /.../
}


/**
* Simply leverage the facade
* */
$intercomUsers = Intercom::users();

Using the instance or the facade, any resource type is mirrored as a method on the Client, that can be used to gain the corresponding resource object :, _(*10)

// facade
$leads = Intercom::leads();

// instance
$intercom = app('intercom');
$conversations = $intercom->conversations();

Using the instance approach you can also resolve the resource instance as a property of the Client:, _(*11)

$conversations = $intercom->conversations;

Here is the list of all the Intercom resources types :, _(*12)

• users
• events
• companies
• messages
• conversations
• leads
• visitors
• admins
• tags
• segments
• counts
• bulk
• notes

You can find related informations on their official documentation page and the api usage for each resource here., _(*13)

In addition, you can also set the token in a fluent way, after the Client has been resolved, using the setToken method:, _(*14)

$intercom->setToken($token)->users->getUser($id);

Defining Macros

To create a macro function, you can use the macro method on either the facade or the instance, this method accepts a name as its first argument, and a callable as its second., _(*15)

// facade
Intercom::macro('usersEmails', function () {
   return // your logic here ... 
});

// instance
$intercom->macro('usersEmails', function () use ($intercom) {
   return // your logic here ... 
});

Your macro can now be called as a regular method on intercom facade or instance, _(*16)

// facade
$userEmails = Intercom::usersEmails();

// instance
$userEmails = $intercom->usersEmails();

License

Mediumart Intercom is an open-sourced software licensed under the MIT license., _(*17)