Grupos e Comunidades
Configurar mensagens temporárias em grupo
POST
/group/ephemeralAutenticaçã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:
0ouoffpara desativar1d7d90d
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)
| Campo | Tipo | Descriçã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.