DOM360
Integrações

Abrir o consentimento do Google

POST
/agents/{agent_id}/integrations/{provider}/authorizations

Devolve o endereço do consentimento do Google para conectar o agente ao provedor, e o state que o amarra a quem pediu, ao agente e ao provedor por dez minutos. O endereço de retorno precisa ser de uma origem desta plataforma. Nada é gravado até a conclusão, pelo PUT do mesmo caminho sem /authorizations.

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

Parâmetros de cabeçalho

Idempotency-Key?|

Chave opcional de 1 a 255 caracteres ASCII visíveis; quando enviada, vale o mesmo contrato da §8.

Corpo da requisição

application/json

Definições TypeScript

Use o tipo request body no TypeScript.

Abrir o consentimento.

Corpo da resposta

application/json

application/json

curl -X POST "https://example.com/agents/string/integrations/string/authorizations" \  -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f" \  -H "Content-Type: application/json" \  -d '{    "redirect_uri": "string"  }'
{  "authorization_url": "string",  "expires_at": "2019-08-24T14:15:22Z",  "state": "string"}