> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Integrações de Ação

> Recuperar o catálogo de integrações de ação disponíveis

# Listar Integrações de Ação

Recupera o catálogo de integrações pré-construídas que podem ser anexadas a ações de agente. Cada integração inclui os metadados necessários para configurá-la (nome de exibição, categoria, schema de configuração).

## Endpoint

```
GET /api/v1/action-integrations
```

## Cabeçalhos da requisição

<ParamField header="Authorization" type="string" required>
  Token Bearer. Formato: `Bearer talq_your_environment_token_here`
</ParamField>

## Exemplos

<RequestExample>
  ```bash theme={null}
  curl "https://app.talkover.ai/api/v1/action-integrations" \
    -H "Authorization: Bearer talq_your_environment_token_here"
  ```
</RequestExample>

## Resposta

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": [
      {
        "identifier": "calendar",
        "display_name": "Calendar",
        "description": "Create events on a connected calendar during a call.",
        "category": "scheduling",
        "icon_url": "https://app.talkover.ai/integrations/icons/calendar.svg"
      },
      {
        "identifier": "email-calendar",
        "display_name": "Email + Calendar Invite",
        "description": "Send a calendar invite via email after the call.",
        "category": "scheduling",
        "icon_url": "https://app.talkover.ai/integrations/icons/email-calendar.svg"
      },
      {
        "identifier": "crm",
        "display_name": "CRM Sync",
        "description": "Push call summary and outcome to your CRM.",
        "category": "data",
        "icon_url": "https://app.talkover.ai/integrations/icons/crm.svg"
      }
    ]
  }
  ```
</ResponseExample>

### Campos da Resposta

<ResponseField name="data[].identifier" type="string" required>
  Identificador único usado ao criar uma ação com `integration: { id: "<identifier>" }`.
</ResponseField>

<ResponseField name="data[].display_name" type="string" required>
  Nome legível exibido no painel.
</ResponseField>

<ResponseField name="data[].description" type="string">
  Descrição curta do que a integração faz.
</ResponseField>

<ResponseField name="data[].category" type="string">
  Grupo ao qual a integração pertence (ex: `scheduling`, `data`, `communication`).
</ResponseField>

<ResponseField name="data[].icon_url" type="string">
  URL pública de um ícone para a integração.
</ResponseField>

## Observações

* Use o valor `identifier` ao criar uma ação via [Criar Ação](/api-reference/endpoints/create-action) — passe-o como `integration.id`.
* As categorias são estáveis; a lista de integrações pode crescer ao longo do tempo.