Pular para o conteúdo

Integracoes

Gerencie integracoes com aplicativos externos via hooks de integracao.

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

Lista todos os aplicativos de integracao disponiveis.

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 integracao para um aplicativo.

Body

NomeTipoObrigatorioDescricao
app_idstringSimID do aplicativo de integracao
inbox_idintegerNaoID do inbox (para integracoes especificas)
settingsobjectNaoConfiguracoes da integracao (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 '{
    "app_id": "dialogflow",
    "settings": {
      "project_id": "meu-projeto",
      "credentials": "..."
    }
  }'
PATCH/api/v1/accounts/{account_id}/integrations/hooks/{hook_id}

Atualiza as configuracoes de um hook de integracao.

Body

NomeTipoObrigatorioDescricao
settingsobjectNaoNovas configuracoes
DELETE/api/v1/accounts/{account_id}/integrations/hooks/{hook_id}

Remove um hook de integracao.

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