Pular para o conteúdo principal
GET
/
api
/
v1
/
action-integrations
curl "https://app.talkover.ai/api/v1/action-integrations" \
  -H "Authorization: Bearer talq_your_environment_token_here"

{
  "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"
    }
  ]
}

​
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

​
Authorization
string
obrigatório
Token Bearer. Formato: Bearer talq_your_environment_token_here

​
Exemplos

curl "https://app.talkover.ai/api/v1/action-integrations" \
  -H "Authorization: Bearer talq_your_environment_token_here"

​
Resposta

{
  "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"
    }
  ]
}

​
Campos da Resposta

​
data[].identifier
string
obrigatório
Identificador único usado ao criar uma ação com integration: { id: "<identifier>" }.
​
data[].display_name
string
obrigatório
Nome legível exibido no painel.
​
data[].description
string
Descrição curta do que a integração faz.
​
data[].category
string
Grupo ao qual a integração pertence (ex: scheduling, data, communication).
​
data[].icon_url
string
URL pública de um ícone para a integração.

​
Observações

  • Use o valor identifier ao criar uma ação via Criar Ação — passe-o como integration.id.
  • As categorias são estáveis; a lista de integrações pode crescer ao longo do tempo.