## Overview

**Integrations** connect ConversaLabs to the rest of your ecosystem. From the integrations area you
enable ready-made connections and create your own extension points:

- **Slack**: mirror conversations in a Slack channel and reply from there.
- **Dialogflow**: connect a Dialogflow bot for automated replies.
- **Notion** and **Linear**: bring conversation context into your productivity and engineering tools.
- **Shopify**: pull order/customer data from your store into support.
- **Webhooks**: receive platform events at your own endpoint, in real time.
- **Dashboard Apps**: embed your own web app next to the conversation.
- **API**: automate and integrate via access tokens.

## Prerequisites

- The **Administrator** role to configure integrations.
- Credentials/accounts for the tools you'll connect (for example, a Slack workspace, a Dialogflow
  project, a Shopify store).
- For webhooks/API: an accessible endpoint and/or an access token generated in the account.

## Step by step

1. Open the **Integrations** area in Settings.
2. Pick the integration and follow the connection flow (usually login/authorization or entering
   keys).
3. For **webhooks**, register your endpoint URL and select the events of interest; validate receipt
   in your system.
4. For the **API**, generate an access token (profile/agent) and use it in authenticated calls.
5. Test the integration with a real conversation before going to production.

## Settings & options

- **Authorization-based connections** (Slack, Shopify, etc.): follow the external tool's login.
- **Key/project-based connections** (Dialogflow): require the provider's credentials.
- **Webhooks per event**: you choose which events to receive.
- **API tokens**: treat them like passwords; revoke them if leaked or unused.

## Use cases

- Notify a Slack channel when a new conversation arrives.
- Automatic triage with a Dialogflow bot before reaching an agent.
- Create a Linear issue from a customer-reported bug.
- Show Shopify order data right on the conversation screen.
- Sync events with your CRM or ERP via webhooks.

## Tips, limits & best practices

- Start with **one** integration, validate the flow, then add others.
- For webhooks, implement **idempotency** and respond fast (process in the background).
- Store tokens in your system's environment variables — never in public source code.
- Review integrations and tokens periodically; remove what's no longer used.

## Troubleshooting

- **The integration won't connect**: check credentials/permissions and try re-authorizing.
- **The webhook isn't arriving**: verify the URL is public, returns success (2xx) and is subscribed
  to the right events.
- **API 401 error**: the token is wrong, expired or revoked — generate a new one.
- **I don't see the integration I want**: it may depend on the plan or a specific enablement.

## See also

- [Custom Scripts: inject JS/CSS](/hc/ajuda/articles/administration-custom-scripts-en)
- [Custom roles and governance (RBAC)](/hc/ajuda/articles/administration-custom-roles-governanca-rbac-en)
- [Audit logs](/hc/ajuda/articles/administration-auditoria-en)
- [Administration overview](/hc/ajuda/articles/administration-overview-en)