Gladly Connector

Connect Gladly so Applied can work with Gladly customers, conversations, inboxes, and replies during support workflows.

Use this Connector when your support team uses Gladly and wants Applied to keep conversation context aligned during escalation, assignment, and reply flows.

Common use cases

Sync Gladly customer and conversation context.
Reply to supported Gladly conversation items.
Add internal notes during escalations.
Restrict ingestion to specific Gladly inboxes.
Route escalations to a configured Gladly inbox.
Sync Gladly conversation assignment, status, close, reopen, and contact session events from webhooks.

Before you begin

Before connecting Gladly, make sure:

You know the Gladly organization subdomain.
You know whether to connect production or sandbox.
A Gladly administrator can create or update the integration user.
The Gladly user for setup has API User permission and keeps the Agent role.
Your team knows which inboxes Applied should ingest from or escalate to.
You have a test conversation available for validation.
You have the Applied webhook URL, webhook username, webhook password, and X-Agent-Id header value from Applied support if you plan to enable webhooks.

If you use the Gladly sandbox, Applied connects to https://<organization>.gladly.qa. Production uses https://<organization>.gladly.com.

Gladly API tokens and webhooks are tied to the Gladly user and environment where they are created. Use separate tokens and webhooks for sandbox and production.

Required Gladly permissions

Create a dedicated Gladly user for Applied when possible. This user should have:

API User permission, so it can create API tokens and use the Gladly REST API.
Agent role, so the token remains attached to an active Gladly agent profile.
Access to the inboxes and conversations Applied should read, reply to, or route escalations into.

To create the webhook, use a Gladly user that can access Settings > App Developer Tools > Webhooks.

Get a Gladly API token

Gladly API tokens are created from Gladly settings.

In Gladly, open Settings.
Under App Developer Tools, go to API tokens.
Click Create Token.
Name the token, such as Applied Labs.
Copy the token.

Use the email address for the Gladly user whose token you created. Applied uses Basic auth with that email and token.

Configure Gladly access

Gladly grants API access through the user. Keep the user as an agent and enable the API User permission.

Gladly API tokens can perform API requests for that account, so use a dedicated Gladly user when possible and keep the token private.

If you want Applied to listen only to selected inboxes, collect the Gladly inbox IDs and enter them as the ingestion inbox IDs. If you want escalations to move to a specific inbox, collect that inbox ID separately.

Connect Gladly in Applied

Open Connectors.
Click New.
Choose Gladly.
Enter the Gladly subdomain.
Enter the Gladly API user email.
Turn on sandbox mode only for a Gladly sandbox.
Optionally enter AI ingestion inbox IDs.
Optionally enter one escalation inbox ID.
Paste the Gladly API token into the API token field.
Create the connection.

Enter multiple ingestion inbox IDs as a comma-separated list.

Configure Gladly webhooks

Gladly webhooks let Applied receive conversation activity as it happens. Create the webhook after the Gladly Connector is created in Applied, because the webhook URL may include the Applied integration ID.

Webhook endpoint

Use the webhook URL provided by Applied. It usually has this shape:


https://core.appliedlabs.ai/v1/integrations/gladly/event/?integration_id=<applied-integration-id>

Use the matching URL for your Applied environment if you are connecting a sandbox or staging workspace.

Webhook authentication

In Gladly, configure the webhook with:

Username: the webhook username provided by Applied.
Password: the webhook password provided by Applied.
HTTP header: add X-Agent-Id with the value provided by Applied.

Do not reuse the Gladly API token as the webhook password unless Applied explicitly tells you to. The API token is for Applied calling Gladly. The webhook username, password, and X-Agent-Id header are for Gladly calling Applied.

Webhook events

Subscribe the Gladly webhook to these events:

CONTACT/MESSAGE_RECEIVED
CONTACT/MESSAGE_SENT
CONTACT/STARTED
CONTACT/ENDED
CONVERSATION/CREATED
CONVERSATION/CLOSED
CONVERSATION/REOPENED
CONVERSATION_ASSIGNEE/UPDATED
CONVERSATION_STATUS/UPDATED

If your Gladly environment exposes the message-level event name, also subscribe to:

MESSAGE/RECEIVED

Gladly sends PING when creating or enabling a webhook to verify the endpoint. You do not need to add PING manually if Gladly sends it automatically during setup.

Create the webhook in Gladly

In Gladly, open Settings.
Under App Developer Tools, click Webhooks.
Click Create Webhook.
Enter a name, such as Applied Labs.
Paste the Applied webhook URL.
Add the events listed above.
Enter the webhook username and password from Applied.
Add the X-Agent-Id HTTP header from Applied.
Turn on Enabled.
Save the webhook.

Gladly expects the endpoint to respond quickly. Applied acknowledges webhook requests immediately and processes authenticated events in the background.

Validate the connection

After setup:

Look up a test Gladly customer or conversation.
Confirm Applied can read the conversation items.
Send a test reply on a non-production conversation if replies are enabled.
If inbox filters are configured, confirm conversations in other inboxes are ignored.
If escalation inbox routing is configured, confirm a test escalation lands in the expected inbox.
If webhooks are configured, send a new customer message in Gladly and confirm it appears in Applied.
Close and reopen the test conversation in Gladly and confirm Applied updates the conversation state.

Common issues

Authentication fails

Confirm the email matches the Gladly user that owns the token and that the user has API User permission.

Applied connects to the wrong Gladly environment

Check the sandbox toggle. Sandbox uses .gladly.qa; production uses .gladly.com.

Conversations are ignored

Review the ingestion inbox ID list. When configured, Applied ingests only from the listed inboxes.

Webhook setup cannot be saved

Confirm the webhook URL is correct and reachable over HTTPS. Gladly verifies the endpoint with a ping when a webhook is created or enabled.

Webhook events stop arriving

Check Gladly webhook logs. Gladly can deactivate a webhook after repeated delivery failures. Resolve the error in the webhook log, then reactivate the webhook.

If Gladly shows successful deliveries but events do not appear in Applied, confirm the webhook username, password, and X-Agent-Id header match the values from Applied.

Replies are not sent from Applied

Confirm the Gladly conversation is open and assigned in a way that allows Applied to reply. Gladly does not allow replies to closed conversations, and Applied does not auto-reply on voice or voicemail contacts.