Integrações

Gerencie integrações com aplicativos externos via hooks de integração.

GET/api/v1/accounts/{account_id}/integrations/apps

Lista todos os aplicativos de integração disponíveis.

bash

curl -s "https://chat.seudominio.com/api/v1/accounts/1/integrations/apps" \
  -H "api_access_token: YOUR_TOKEN" | jq .

200Lista de apps

json

{
  "payload": [
    {
      "id": "slack",
      "name": "Slack",
      "description": "Integração com Slack",
      "enabled": false
    },
    {
      "id": "dialogflow",
      "name": "Dialogflow",
      "description": "NLP e chatbot",
      "enabled": true
    }
  ]
}

POST/api/v1/accounts/{account_id}/integrations/hooks

Cria um hook de integração para um aplicativo.

Body (envolto em objeto hook)

Nome	Tipo	Obrigatorio	Descricao
`app_id`	`string`	Sim	ID do aplicativo de integração
`inbox_id`	`integer`	Nao	ID do inbox (para integrações específicas)
`status`	`boolean`	Nao	Estado de ativação do hook
`settings`	`object`	Nao	Configurações da integração (varia por app)

bash

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/integrations/hooks" \
  -H "api_access_token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "hook": {
      "app_id": "dialogflow",
      "settings": {
        "project_id": "meu-projeto"
      }
    }
  }'

PATCH/api/v1/accounts/{account_id}/integrations/hooks/{hook_id}

Atualiza as configurações de um hook de integração.

Body (envolto em objeto hook)

Nome	Tipo	Obrigatorio	Descricao
`status`	`boolean`	Nao	Ativar/desativar o hook
`settings`	`object`	Nao	Novas configurações

DELETE/api/v1/accounts/{account_id}/integrations/hooks/{hook_id}

Remove um hook de integração.

bash

curl -X DELETE "https://chat.seudominio.com/api/v1/accounts/1/integrations/hooks/5" \
  -H "api_access_token: YOUR_TOKEN"