PHPackages                             wisembly/intercom-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. wisembly/intercom-php

ActiveLibrary

wisembly/intercom-php
=====================

v1.0.6(11y ago)67.3k2[2 PRs](https://github.com/Wisembly/intercom-php/pulls)MITPHPPHP >=5.4.0

Since Apr 23Pushed 11y ago14 watchersCompare

[ Source](https://github.com/Wisembly/intercom-php)[ Packagist](https://packagist.org/packages/wisembly/intercom-php)[ Docs](https://github.com/wisembly/intercom-php)[ RSS](/packages/wisembly-intercom-php/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (7)Dependencies (3)Versions (10)Used By (0)

[![Build Status](https://camo.githubusercontent.com/15b2535e5806b1a1e27bfcf35c5aa86e3c0f9da371dd64396cbc7e033cc5e846/68747470733a2f2f6170692e7472617669732d63692e6f72672f576973656d626c792f696e746572636f6d2d7068702e737667)](http://travis-ci.org/Wisembly/intercom-php)

Intercom-php
============

[](#intercom-php)

This little library allows you to use Intercom API more easily. It provides clients to manage your users or your events fluently.

The curl client used is [Guzzle](https://github.com/guzzle/guzzle). Instanciate Guzzle with your configuration and give it to your Intercom client with you credentials and it's ready go !

[Intercom API documentation](http://doc.intercom.io/api/)

Versioning
==========

[](#versioning)

For the moment the library is in "Work In Progress". Master move fast and I don't guarantee BC before announcing a stable version in 1.1.0.

Installation
============

[](#installation)

1. Install composer : `curl -s http://getcomposer.org/installer | php`(more info at getcomposer.org)
2. Create a `composer.json` file in your project root : (or add only the excelant line in your existing composer file)

```
  {
    "require": {
      "wisembly/intercom-php": "*",
    }
  }
```

3. Install via composer : `php composer.phar install`

Use Intercom-php
================

[](#use-intercom-php)

Create the client for manage Users
----------------------------------

[](#create-the-client-for-manage-users)

```
use GuzzleHttp\Client as Guzzle;
use Intercom\Client\User as Intercom;

$guzzleHttp = new Guzzle;
$intercom = new Intercom('APP_ID', 'API_KEY', $guzzle);
```

Actions
-------

[](#actions)

Now you can do all the requests that the Intercom User API allows. For each actions, you need to create a User object that represents your Intercom User.

### Create

[](#create)

```
use Intercom\Object\User;

$user = new User(1, 'foo@company.com'); // user_id or email
$intercom->create($user);
```

### Update

[](#update)

```
use Intercom\Object\User;

$user = new User(1, 'foo@company.com'); // user_id or email
$intercom->update($user);
```

### Delete

[](#delete)

```
use Intercom\Object\User;

$user = new User(1, 'foo@company.com'); // user_id or email
$intercom->delete($user);
```

### Get

[](#get)

```
$user = $intercom->get(1, 'foo@company.com'); // user_id or email
```

### Search

[](#search)

To search users through all your Intercom database, use an instance of `UserSearch` that allows you to find users with specified attributes.

```
use Intercom\Request\Search\UserSearch;

// Retrieve the first ten users with tag name "premium"
$search = new UserSearch(1, 10, null, 'premium');

$users = $intercom->search($search);
```

See the complete documentation of this [search API](https://github.com/Wisembly/intercom-php/blob/master/lib/Intercom/Request/Search/UserSearch.php#L31).

### Use case : How to retrieve all your Intercom users ?

[](#use-case--how-to-retrieve-all-your-intercom-users-)

By default the Intercom API allows you to retrieve 500 entities per request.

```
use GuzzleHttp\Client as Guzzle;
use Intercom\Request\UserSearch;
use Intercom\Client\User as Intercom;

// Create the client
$guzzle = new Guzzle;
$intercom = new Intercom('APP_ID', 'API_KEY', $guzzle);

// Create a search with defaut parameters
$search = new UserSearch;

$users = [];

// Fetch all users
do {
    $response = $intercom->search($search);
    $users = array_merge($users, $response->getContent());
    $search->setPage($response->getNextPage());
} while ($response->hasPageToBeFetch());
```

TODO
====

[](#todo)

- Tagging
- Notes
- Impressions
- Messages threads

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 97.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~11 days

Recently: every ~17 days

Total

7

Last Release

4338d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/11400ade55a71197808c548868ec15b5061fd4f88accaafcdd799beb40324403?d=identicon)[guillaumepotier](/maintainers/guillaumepotier)

---

Top Contributors

[![rgazelot](https://avatars.githubusercontent.com/u/1488251?v=4)](https://github.com/rgazelot "rgazelot (46 commits)")[![gmajoulet](https://avatars.githubusercontent.com/u/1492044?v=4)](https://github.com/gmajoulet "gmajoulet (1 commits)")

---

Tags

intercom

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/wisembly-intercom-php/health.svg)

```
[![Health](https://phpackages.com/badges/wisembly-intercom-php/health.svg)](https://phpackages.com/packages/wisembly-intercom-php)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[craftcms/cms

Craft CMS

3.6k3.6M2.6k](/packages/craftcms-cms)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[intercom/intercom-php

Intercom API client.

30320.5M26](/packages/intercom-intercom-php)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)