Skip to content

Contacts+

With Contacts+ modules in Ibexa Connect, you can:

  • watch contacts created, updated, and deleted, list retrieve, created, and update contacts

  • watch tags created, updated, and deleted, retrieve, create, update tags, and add and remove tags from the contact

  • watch the business cards transcribed

To get started with Contacts+, create an account at contactplus.com.

Connect Contacts+ to Ibexa Connect

To connect Contacts+ app, you need to obtain the user credentials.

  1. Log in to your Ibexa Connect account, insert a Contacts+ module in your scenario and click the Add button next to the Connection field.

    Contatcs__1.gif

  2. In the Connection name field, enter a name for the connection and click Save.

  3. Optional: Click Show Advanced Settings and enter the client credentials of your own app. See Create your custom app and client credentials.

    contacts_-6.png

  4. Click Authorize to allow Ibexa Connect access to your data.

    Contacts__2.png

You have successfully connected the Contacts+ app and can now build scenarios.

Create your custom app and client credentials

To create your own app:

  1. Log in to your Contacts+ account and access Settings > Apps.

  2. Click Create New App.

    contacts_-3.png

  3. Enter the app's name, and description, add the following redirect URIs and click Create App.

    contacts_-4.png

  4. Copy the Client ID and Client Secret value to a safe place and click Close.

    contacts_-5.png

You have successfully created your own app and retrieved client credentials.

Contacts

You can watch contacts created, updated, and deleted, list retrieve, created, and update contacts using the following modules.

Watch Contacts Created

Triggers when a new contact is created.

Note

Ibexa Connect automatically creates a webhook in Contacts+ once you add an instant trigger to your scenario.

Webhook name Enter a name for the webhook.
Team ID Select or map the Team ID whose created contacts you want to watch.

Watch Contacts Deleted

Triggers when an existing contact is Deleted.

Note

Ibexa Connect automatically creates a webhook in Contacts+ once you add an instant trigger to your scenario.

Webhook name Enter a name for the webhook.
Team ID Select or map the Team ID whose deleted contacts you want to watch.

Watch Contacts Updated

Triggers when an existing contact is Updated.

Webhook name Enter a name for the webhook.
Team ID Select or map the Team ID whose updated contacts you want to watch.

List Contacts

Gets a list of contacts.

Team ID Select or map the Team ID whose contacts you want to list.
Limit Set the maximum number of contacts Ibexa Connect will return during one execution cycle. The default value is 10.

Get a Contact

Gets an existing contact.

For field descriptions, see the Contacts+ Contacts API reference.

Create a Contact

Creates a new contact.

For field descriptions, see the Contacts+ Contacts API reference.

Update a Contact

Updates an existing contact.

For field descriptions, see the Contacts+ Contacts API reference.

Tags

You can watch tags created, updated, and deleted, retrieve, create, update tags, and add and remove tags from the contact using the following modules.

Watch Tags Created

Triggers when a new tag is created.

Note

Ibexa Connect automatically creates a webhook in Contacts+ once you add an instant trigger to your scenario.

Webhook name Enter a name for the webhook.
Team ID Select or map the Team ID whose created tags you want to watch.

Watch Tags Deleted

Triggers when an existing tag is deleted.

Note

Ibexa Connect automatically creates a webhook in Contacts+ once you add an instant trigger to your scenario.

Webhook name Enter a name for the webhook.
Team ID Select or map the Team ID whose deleted tags you want to watch.

Watch Tags Updated

Triggers when an existing tag is Updated.

Note

Ibexa Connect automatically creates a webhook in Contacts+ once you add an instant trigger to your scenario.

Webhook name Enter a name for the webhook.
Team ID Select or map the Team ID whose updated tags you want to watch.

Get a Tag

Gets an existing tag.

For field descriptions, see the Contacts+ Tags API reference.

Create a Tag

Creates a new tag.

Tag Name Enter the name of the tags you want to create.
Team ID Select or map the Team ID whose tags you want to create.

Update a Tag

Updates an existing tag.

For field descriptions, see the Contacts+ Tags API reference.

Add Tags to the Contact

Adds tags to the existing contact.

For field descriptions, see the Contacts+ Tags API reference.

Remove Tags from the Contact

Removes tags from the existing contact.

For field descriptions, see the Contacts+ Tags API reference.

Business Cards

You can watch the business cards transcribed using the following modules.

Watch Business Card Transcribed

Triggers when a business card has been transcribed.

Note

Ibexa Connect automatically creates a webhook in Contacts+ once you add an instant trigger to your scenario.

Webhook name Enter a name for the webhook.
Team ID Select or map the Team ID whose business card transcribed you want to watch.

Other

You can call APIs using the following module.

Make an API Call

Performs an arbitrary authorized API call.

Note

For the list of available endpoints, refer to the Contacts+ API documentation.

URL Enter a path relative to https://api.contactsplus.com. For example, /v1/account.get.
Headers Enter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query String Enter the request query string.
Body Enter the body content for your API call.

EXAMPLE OF USE - SEARCH TASKS

The following API call returns all tasks from your account.

URL: /v1/teams.get

msedge_UL0tW9KYkg.png

Matches of the search can be found in the module's Output under Bundle > Body > teams.

In our example, 1 team is returned:

msedge_dPKO7O8Obb.png