# Gosquared AI integration on Definable

> GoSquared provides real-time web analytics and customer engagement tools to help businesses understand and interact with their website visitors.

## What this connects

GoSquared provides real-time web analytics and customer engagement tools to help businesses understand and interact with their website visitors.

Vendor: https://www.gosquared.com/

## Tools available

**90** tools available. First 12:

- `GOSQUARED_ACCOUNT_ADD_SHARED_USER` — Add Shared User — Tool to add a new shared user to a project. Use when inviting team members via their email address.
- `GOSQUARED_ACCOUNT_REMOVE_SHARED_USER` — Remove shared user — Removes a shared user from a GoSquared project by their email address, revoking their access to the site. Requires owner-level API key permissions. Use GOSQUARED_ACCOUNT_SHARED_USERS first to list current shared users.
- `GOSQUARED_ACCOUNT_SHARED_USERS` — Account Shared Users — Retrieves all team members who have access to the current GoSquared project. Returns each user's ID, email, access state (owner/active/pending), and role (owner/admin/member). Requires an API key with owner-level permissions for the project. Use this to audit project access or verify team member invitations.
- `GOSQUARED_ACCOUNT_SITES` — List Account Sites — List all projects/sites accessible to the authenticated account. Requires 'read_account' API key scope. Use 'grouped' format to see owned vs shared sites, or 'flat' for a simple list.
- `GOSQUARED_AUTH_TOKEN_INFO` — Check API Token Validity and Scopes — Tool to check whether an API key is valid and retrieve its enabled scopes. Use when verifying API credentials before making further API calls.
- `GOSQUARED_BLOCK_VISITOR` — Block Visitor — Tool to block a specific visitor from being tracked. Use when you need to prevent tracking for a particular visitor ID.
- `GOSQUARED_CHAT_CHAT` — Retrieve Chat Conversation — Retrieve detailed information about a chat conversation by its ID. Use this tool when you need to: - Get the current state of a chat conversation (agent assignment, read status) - View the latest message in a conversation - Check visitor presence and contact details - Determine if a chat is archived or active Prerequisites: Obtain a valid chatID from GOSQUARED_CHAT_CHATS or use a person_id from GOSQUARED_LIST_PEOPLE. Note: To retrieve the full conversation history with all messages, use GOSQUARED_CHAT_FEED instead. This endpoint returns summary information and only the latest message.
- `GOSQUARED_CHAT_CHAT_MESSAGES` — Retrieve Chat Messages — Retrieve messages from a GoSquared chat conversation by chat ID. Use this tool to: - Fetch message history from a specific chat conversation - Page through chat messages with offset and limit - Filter messages by date range - Get the total count of messages via the cardinality field Prerequisites: - Obtain a valid chatID from GOSQUARED_CHAT_CHATS or GOSQUARED_CHAT_CHAT actions - The chatID corresponds to the person_id of the visitor Returns: - A list of messages with timestamp, sender, and text content - Cardinality field showing the total message count
- `GOSQUARED_CHAT_CHATS` — Retrieve Chat Conversations — Tool to retrieve chat data for reporting purposes. Use when you need to list active chat conversations within a specific time window.
- `GOSQUARED_CHAT_FEED` — Retrieve Chat Feed — Retrieve the complete feed of messages and events from a chat conversation. Use this action to: - Fetch chat history and conversation timeline for a specific person - Review messages exchanged between agents, bots, and visitors - Access internal/private agent notes and public messages - Track chat events like archiving, status changes, etc. - Retrieve messages with rich content including emojis and Unicode text The chat_id corresponds to a person_id from the GoSquared People API. You can obtain valid person_id values by first calling the List People action. Supports pagination and date filtering to retrieve specific portions of the chat history. Feed items are typically returned in reverse chronological order.
- `GOSQUARED_CREATE_ACCOUNT_WEBHOOK` — Create Account Webhook — Tool to create a webhook to receive notifications about events in a GoSquared project. Use when you need to register a new webhook endpoint for real-time event notifications.
- `GOSQUARED_CREATE_WEBHOOK_TRIGGER` — Create Webhook Trigger — Tool to add a trigger to an existing GoSquared webhook. Use when configuring webhook alerts for traffic spikes, traffic dips, chat messages, or smart group events.

## Auth

Auth schemes: `API_KEY`.

## How agents use Gosquared

Inside a Definable workflow, Gosquared is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Gosquared** — the Researcher (GPT-5.5) pulls context from Gosquared (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Gosquared** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Gosquared (create record, post message, draft email).
- **Designer / Engineer → Distributor → Gosquared** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Gosquared (attach file, open PR comment, post status).

The Verifier checks every Gosquared call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- analytics — https://definable.ai/apps/category/analytics/
- marketing automation — https://definable.ai/apps/category/marketing-automation/

## Related

- HTML page: https://definable.ai/apps/gosquared/
- Same category (analytics): https://definable.ai/apps/category/analytics/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt