IssuedInstance

Estrutura de dados do contrato OpenAPI.

Estrutura de dados do contrato OpenAPI.

Campos

CampoTipoPresençaDescrição
idstringobrigatórioFormato: uuid
namestringobrigatório—
systemNamestringopcional—
companyIdstringopcional—
statusstringobrigatórioValores: "disconnected", "connecting", "connected"
ownerstringobrigatório—
profileNamestringobrigatório—
qrcodestringobrigatórioPNG em data URI quando há QR vigente; vazio no restante e nas listagens.
paircodestringopcional—
lastDisconnectstringopcionalRFC 3339. Formato: date-time
lastDisconnectReasonstringopcional—
disconnectCodestringopcional—
workerstringopcional—
limitEnforcementstringopcional—
limitUntilstringopcionalRFC 3339. Formato: date-time
createdstringopcionalRFC 3339. Formato: date-time
updatedstringopcionalRFC 3339. Formato: date-time
kindstringobrigatórioValores: "whatsapp", "calls"
callsMaxConcurrentintegeropcionalLimite próprio de ligações simultâneas da instância calls: voz e vídeo, recebidas e realizadas, incluindo ringing/connecting/active e reservas de discagem. Acima de 1 ainda depende de homologação em chamadas reais. Mínimo: 1. Máximo: 8
callsConfigVersionintegeropcionalVersão crescente da configuração de chamadas; presente inclusive 0 em objetos instance de kind=calls. Comparar esta versão entre respostas HTTP e snapshots de webhook para evitar regressões. O campo não pertence às instâncias whatsapp. Mínimo: 0. Formato: int64
incomingCallModestringopcionalComportamento para novas chamadas recebidas: allow permite atendimento humano; reject recusa no servidor; reject_reply recusa e solicita ao consumidor resposta por uma conexão de mensagens vinculada. Não atende automaticamente. O envio do texto é independente da recusa. Modelo: IncomingCallMode. Valores: "allow", "reject", "reject_reply"
tokenstringobrigatórioSegredo de instância: guardar no backend. Só criação/reemissão; replay idempotente de init pode repetir por 15 min. Comprimento mínimo: 64. Comprimento máximo: 64

Definição OpenAPI

json
{
  "allOf": [
    {
      "$ref": "#/components/schemas/Instance"
    },
    {
      "type": "object",
      "properties": {
        "token": {
          "type": "string",
          "description": "Segredo de instância: guardar no backend. Só criação/reemissão; replay idempotente de init pode repetir por 15 min.",
          "minLength": 64,
          "maxLength": 64
        }
      },
      "required": [
        "token"
      ]
    }
  ]
}