Receber a conversa do Copiloto

POST

/connectors/{connectorId}/build/handoff

curl --request POST \
  --url https://api-connect.zoppy.com.br/connectors/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/build/handoff \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "summary": "example" }'

• Produção
• Staging

Leva o resumo que o Copiloto escreveu para a conversa de construção, que segue daí no modo construção.

Authorizations

• bearer

Parameters

Path Parameters

connectorId

required

Id do conector

string format: uuid

Id do conector

Request Body^required

Media typeapplication/json

object

summary

required

O resumo que o Copiloto escreveu da conversa

string

>= 1 characters <= 4000 characters

Example ^generated

{
  "summary": "example"
}

Responses

200

A conversa

Media typeapplication/json

object

connectorId

required

string format: uuid

messages

required

Array

One of:

object

object

id

required

string

kind

required

string

Allowed values: text

author

required

string

Allowed values: person ai

text

required

string

object

object

id

required

string

kind

required

string

Allowed values: activity

activity

required

string

Allowed values: reading_docs connecting counting discovering_tables writing_version rehearsing masked_secret

detail

required

string

object

object

id

required

string

kind

required

string

Allowed values: access_request

secrets

required

Array<string>

agentId

required

string

nullable

object

object

id

required

string

kind

required

string

Allowed values: host_request

hosts

required

Array<string>

object

object

id

required

string

kind

required

string

Allowed values: secret_reuse_request

fromConnectorId

required

O conector da mesma loja e do mesmo sistema de onde viria o acesso

string

fromName

required

string

secrets

required

Os segredos que seriam copiados, só os nomes

Array<string>

spend

required

object

currency

required

Moeda dos valores (BRL)

string

conversationSpent

required

Gasto desta conversa de construção, em reais

number

conversationCap

required

Teto por conversa de construção, em reais

number

monthSpent

required

Gasto da loja no mês com copiloto e construção, em reais

number

monthCap

required

Teto mensal da loja, em reais

number

stopped

required

O teto da conversa ou o mensal foi atingido: a conversa para

boolean

answering

required

A IA está respondendo a última mensagem

boolean

Example

{
  "messages": [
    {
      "kind": "text",
      "author": "person"
    }
  ]
}

400

Entrada inválida (validation_failed)

Media typeapplication/json

object

type

required

Código estável do erro, para máquinas (ex.: connect.connector_not_found)

string

title

required

Nome da classe do erro

string

status

required

Status HTTP

integer

detail

required

Mensagem em pt-BR, segura para mostrar a quem usa a tela

string

requestId

required

Id de correlação: passe ao suporte para achar o rastro completo

string

nullable

meta

Detalhes estruturados seguros para a tela (erros de campo, ids)

object

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "requestId": "example",
  "meta": {
    "additionalProperty": "example"
  }
}

401

Token ausente, inválido ou expirado (connect.unauthorized)

Media typeapplication/json

object

type

required

Código estável do erro, para máquinas (ex.: connect.connector_not_found)

string

title

required

Nome da classe do erro

string

status

required

Status HTTP

integer

detail

required

Mensagem em pt-BR, segura para mostrar a quem usa a tela

string

requestId

required

Id de correlação: passe ao suporte para achar o rastro completo

string

nullable

meta

Detalhes estruturados seguros para a tela (erros de campo, ids)

object

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "requestId": "example",
  "meta": {
    "additionalProperty": "example"
  }
}

403

Papel sem acesso ou Connect não liberado (connect.forbidden_role, connect.feature_disabled)

Media typeapplication/json

object

type

required

Código estável do erro, para máquinas (ex.: connect.connector_not_found)

string

title

required

Nome da classe do erro

string

status

required

Status HTTP

integer

detail

required

Mensagem em pt-BR, segura para mostrar a quem usa a tela

string

requestId

required

Id de correlação: passe ao suporte para achar o rastro completo

string

nullable

meta

Detalhes estruturados seguros para a tela (erros de campo, ids)

object

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "requestId": "example",
  "meta": {
    "additionalProperty": "example"
  }
}

503

IA de construção não disponível neste ambiente (connect.build_unavailable)

Media typeapplication/json

object

type

required

Código estável do erro, para máquinas (ex.: connect.connector_not_found)

string

title

required

Nome da classe do erro

string

status

required

Status HTTP

integer

detail

required

Mensagem em pt-BR, segura para mostrar a quem usa a tela

string

requestId

required

Id de correlação: passe ao suporte para achar o rastro completo

string

nullable

meta

Detalhes estruturados seguros para a tela (erros de campo, ids)

object

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "requestId": "example",
  "meta": {
    "additionalProperty": "example"
  }
}