NODAPI

Grupos e Comunidades

Configurar mensagens temporárias em grupo

POST/group/ephemeral

Autenticação: envie a chave da conexão no header token ou em Authorization: Bearer.

Define o temporizador de mensagens temporárias (disappearing messages) de um grupo.

Valores aceitos para a duração:

  • 0 ou off para desativar
  • 1d
  • 7d
  • 90d

Observações:

  • este endpoint é apenas para grupos
  • requer privilégios de administrador do grupo
  • se o identificador informado não for de grupo, a API retorna erro orientando usar /chat/ephemeral
  • após sucesso, a resposta devolve o chat atualizado e o snapshot mais recente do grupo no cache local

Corpo da requisição (JSON)

CampoTipoDescrição
groupjid*string

JID do grupo no formato [email protected]

Exemplo: [email protected]

duration*any

Duração desejada para mensagens temporárias

Exemplo: 1d

* obrigatório

Exemplos de corpo

Ativar por 1 dia

{
  "groupjid": "[email protected]",
  "duration": "1d"
}

Desativar mensagens temporárias

{
  "groupjid": "[email protected]",
  "duration": "off"
}

Respostas

  • 200Temporizador atualizado com sucesso
  • 400Payload inválido, grupo inválido ou duração não suportada
  • 401Token inválido ou ausente
  • 403Usuário não é administrador do grupo
  • 500Erro interno ao atualizar o temporizador

Experimente

Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.

Cole a chave gerada no painel.