DOM360
Integrações

Concluir a conexão do agente

PUT
/agents/{agent_id}/integrations/{provider}

Troca o código que o Google devolveu pela autorização e a grava no agente, substituindo a conexão anterior. O state precisa ser o que esta mesma pessoa recebeu ao abrir o consentimento para este agente e este provedor. Quem consentiu fica como dono da credencial; ela morre com o agente.

Autorização

bearer integrations:write
AutorizaçãoBearer <token>

Credencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.

Em: header

Escopo: integrations:write

Parâmetros de caminho

agent_id*string

Id do agente

provider*string

google-calendar ou gmail

Corpo da requisição

application/json

Definições TypeScript

Use o tipo request body no TypeScript.

Concluir o consentimento com o que o Google devolveu.

Corpo da resposta

application/json

application/json

curl -X PUT "https://example.com/agents/string/integrations/string" \  -H "Content-Type: application/json" \  -d '{    "code": "string",    "redirect_uri": "string",    "state": "string"  }'
{  "account_email": "string",  "active": true,  "connected": true,  "last_used_at": "2019-08-24T14:15:22Z",  "missing_scopes": [    "string"  ],  "needs_reconsent": true,  "provider": "google-calendar",  "token_expires_at": "2019-08-24T14:15:22Z"}