Intercom PHP SDK

Intercom PHP SDK Examples

📘

Installation and Configuration Steps

For information on how to install and configure the Intercom PHP SDK please see the intercom-php github page. For general code examples please see below.

Clients

Using OAuth or Access Tokens

use Intercom\IntercomClient; 
 $client = new IntercomClient(<insert_token_here>, null);

Users

Create (or update) a user

$client->users->create(["email" => "[e-mail]"]);

Delete a user by ID

$client->users->deleteUser("570680a8a1bcbca8a90001b9");

Add companies to a user

// Add companies to a user
$client->users->create(["email" => "[e-mail]",
  "companies" => [
    [
      "id" => "3"
    ]
  ]
]);

Find a single user by email

$client->users->getUsers(["email" => "[e-mail]"]);

List all users

$client->users->getUsers([]);

Leads

Create/update a lead

// See more options here: https://developers.intercom.io/reference#create-lead
$client->leads->create([]);

Delete a lead by ID

$client->leads->deleteLead("570680a8a1bcbca8a90000a9");

Convert a Lead to a User

$leads->convertLead([
  "contact" => [
    "user_id" => "8a88a590-e1c3-41e2-a502-e0649dbf721c"
  ],
  "user" => [
    "email" => "[e-mail]"
  ]
]);

Find a lead by ID

$client->leads->getLead("570680a8a1bcbca8a90000a9");

List leads

// See more options here: https://developers.intercom.io/reference#list-leads
$client->leads->getLeads([]);

Tags

Tag users

$client->tags->tag([
  "name" => "Test",
  "users" => [
    ["id" => "1234"]
  ]
]);

List tags

$client->tags->getTags();

Events

Create an event

$client->events->create([
  "event_name" => "testing",
  "created_at" => 1391691571,
  "email" => "[e-mail]"
]);

View events for a user

$client->events->getEvents(["email" => "[e-mail]"]);

Companies

Create a company

$client->companies->create([
  "name" => "foocorp", "id" => "3"
]);

List Companies

$client->companies->getCompanies([]);

Admins

List admins

$client->admins->getAdmins();

Messages

Send a message from an admin to a user

// See more options here: https://developers.intercom.io/reference#conversations
$client->messages->create([
  "message_type" => "inapp",
  "subject" => "Hey",
  "body" => "Ponies, cute small horses or something more sinister?",
  "from" => [
    "type" => "admin",
    "id" => "1234"
  ],
  "to" => [
    "type" => "user",
    "email" => "[e-mail]"
  ]
]);

Conversations

List conversations for an admin

// See more options here: https://developers.intercom.io/reference#list-conversations
$client->conversations->getConversations([
  "type" => "admin",
  "admin_id" => "25610"
]);

Get a single conversation

$client->conversations->getConversation("1234")

Reply to a conversation

// See more options here: https://developers.intercom.io/reference#replying-to-a-conversation
$client->conversations->replyToConversation("5678", [
  "email" => "[e-mail]",
  "body" => "Thanks :)",
  "type" => "user",
  "message_type" => "comment"
]);

Counts

List counts

// See more options here: https://developers.intercom.io/reference#getting-counts
$client->counts->getCounts([])

Notes

Create a note

$client->notes->create([
  "admin_id" => "21",
  "body" => "Text for my note",
  "user" => [
    "id" => "5310d8e8598c9a0b24000005"
  ]
]);

List notes for a user

$client->notes->getNotes([
  "user_id" => "25"
]);

Get a single Note by id

$client->notes->getNote("42");

Pagination

Lists return pages

When listing, the Intercom API may return a pagination object:

{
  "pages": {
    "next": "..."
  }
}

Get the next page

//You can grab the next page of results using the client:
$client->nextPage($response["pages"]);