CodeChat APIv1.0.0
ChangelogPostman
Referência/Calls/startExistingGroupCall
Calls

Inicia chamada em grupo existente

Inicia chamada em grupo existente

Pro
POSThttp://localhost:8084/call/{instanceName}/groups/{groupId}

Autenticação

InstanceBearerobrigatório

JWT HS256 da própria instância.

Header
Authorization
Exemplo
Bearer <INSTANCE_TOKEN>

Parâmetros

instanceNamepathobrigatório
string

Nome publico da instancia

minLength 1
groupIdpathobrigatório
string

Sem descrição adicional.

Request body

obrigatório
bodyobject
videobooleanpadrão: false
participantsarrayobrigatório
items[]string
titlestring
Exemplo JSONgerado do schema
{
  "video": false,
  "participants": [
    "string"
  ],
  "title": "string"
}

Respostas

application/json
201

Group call created

response 201object
callallOfobrigatório
opção 1object
idstringobrigatórioformat: uuid
instanceIdintegerobrigatório
instancestring
providerstringobrigatório
providerCallIdstring
directionenum<incoming | outgoing>obrigatório
statusenum<INCOMING | OUTGOING | RINGING | PREACCEPTED | CONNECTING | ACTIVE | ENDING | ENDED | ENDED_UNCONFIRMED | REJECTED | MISSED | BUSY | FAILED | INTERRUPTED | ANSWERED_ELSEWHERE | REJECTED_ELSEWHERE>obrigatório
peerstring | null
peerJidstring
audiobooleanobrigatório
videobooleanobrigatório
localVideoActiveboolean
remoteVideoActiveboolean
recordingEnabledboolean
recordingRequestedboolean
recordingStartedboolean
recordingCompletedboolean
recordingAvailableboolean
recordingStatusenum<NOT_REQUESTED | PENDING | RECORDING | FINALIZING | PROCESSING | COMPLETED | PARTIAL | FAILED | UNAVAILABLE>
recordingUnavailableReasonenum<media_owned_by_another_device>
recordingStartedAtstringformat: date-time
recordingCompletedAtstringformat: date-time
answeredByenum<api | another_device | unknown>
endedByenum<api | peer | another_device | provider | timeout | application | unknown>
answerRequestedByenum<api | another_device | unknown>
endReasonstring
providerReasonstring
stateVersioninteger
lastProviderEventAtstringformat: date-time
startedAtstringobrigatórioformat: date-time
ringingAtstringformat: date-time
answeredAtstringformat: date-time
connectedAtstringformat: date-time
endedAtstringformat: date-time
durationSecondsinteger
opção 2object
typeenum<GROUP | AD_HOC_GROUP | CALL_LINK>obrigatório
groupIdstring
callLinkIdstringformat: uuid
titlestring
approvalRequiredboolean
participantCountintegerobrigatóriomín: 0
maxParticipantsintegermín: 2
participantsarrayobrigatório
items[]object
idstringobrigatórioformat: uuid
instanceIdintegerobrigatório
callIdstringobrigatórioformat: uuid
participantJidstringobrigatório
participantLidstring
deviceJidstring
phoneNumberstring
displayNamestring
roleenum<HOST | CREATOR | MODERATOR | PARTICIPANT>obrigatório
statusenum<INVITED | RINGING | WAITING_APPROVAL | ADMITTED | REJECTED | JOINING | JOINED | LEFT | FAILED>obrigatório
audioEnabledboolean
audioMutedboolean
videoEnabledboolean
screenShareEnabledboolean
raisedHandboolean
Exemplo 201gerado do schema
{
  "call": {
    "id": "01900000-0000-7000-8000-000000000001",
    "instanceId": 1,
    "instance": "minha-instancia",
    "provider": "string",
    "providerCallId": "string",
    "direction": "incoming",
    "status": "INCOMING",
    "peer": "string",
    "peerJid": "[email protected]",
    "audio": true,
    "video": true,
    "localVideoActive": true,
    "remoteVideoActive": true,
    "recordingEnabled": true,
    "recordingRequested": true,
    "recordingStarted": true,
    "recordingCompleted": true,
    "recordingAvailable": true,
    "recordingStatus": "NOT_REQUESTED",
    "recordingUnavailableReason": "media_owned_by_another_device",
    "recordingStartedAt": "2026-07-13T15:10:00Z",
    "recordingCompletedAt": "2026-07-13T15:10:00Z",
    "answeredBy": "api",
    "endedBy": "api",
    "answerRequestedBy": "api",
    "endReason": "string",
    "providerReason": "string",
    "stateVersion": 1,
    "lastProviderEventAt": "2026-07-13T15:10:00Z",
    "startedAt": "2026-07-13T15:10:00Z",
    "ringingAt": "2026-07-13T15:10:00Z",
    "answeredAt": "2026-07-13T15:10:00Z",
    "connectedAt": "2026-07-13T15:10:00Z",
    "endedAt": "2026-07-13T15:10:00Z",
    "durationSeconds": 1,
    "type": "GROUP",
    "groupId": "string",
    "callLinkId": "01900000-0000-7000-8000-000000000001",
    "title": "string",
    "approvalRequired": true,
    "participantCount": 1,
    "maxParticipants": 2
  },
  "participants": [
    {
      "id": "01900000-0000-7000-8000-000000000001",
      "instanceId": 1,
      "callId": "01900000-0000-7000-8000-000000000001",
      "participantJid": "[email protected]",
      "participantLid": "string",
      "deviceJid": "[email protected]",
      "phoneNumber": "5511999999999",
      "displayName": "CodeChat",
      "role": "HOST",
      "status": "INVITED",
      "audioEnabled": true,
      "audioMuted": true,
      "videoEnabled": true,
      "screenShareEnabled": true,
      "raisedHand": true
    }
  ]
}