API

Contact

A Contact represents a human or company. Every Case (ticket) has a contact associated with it. Normally a Contact is a customer or someone that wants to interact with us through one or multiple channels. Contacts interact with us through their Profiles (a contact has at least one profile in the system).

Contacts can be synchronized with existing customer and lead data in CRMs or Marketing automation systems. Social Gateway provides 2 fields for this purpose:

crm_id
client_id

Using the Contacts API you can feed your CRM or Marketing tools with the activity gathered about each person in Social Networks, emails, chats and any communication channel you plugged into Social Gateway.

Create / Import a Contact

POST /api/v2/contact

Creates a Contact in Social Gateway. See Create Contact API

Update a Contact

POST /api/v2/contact/CONTACT_ID

Updates a Contact with the passed in information. See Update Contact API

Get a Contact

GET /api/v2/contact/CONTACT_ID

Retrieves the data associated with a Contact. The Get Contact API lets you find out basic information about a client, lead, troll or company.

Search Contacts

GET /api/v2/contact

Retrieves the contacts matching a search criteria. The Search Contact API lets you find the contacts based on many different attributes.

Manage Profiles

GET /api/v2/contact/CONTACT_ID/profiles

Lists, adds and removes profiles from a Contact. The Contact Profiles API lets you manage the profile that a Contact has with ease.

Manage Tags

GET /api/v2/contact/CONTACT_ID/tags

Lists, adds and removes tags from a Contact. The Tag Contact API lets you manage the tags of a Contact with ease.