Conversas em grupo

​

Como grupos diferem de 1:1

​

Crie o grupo e estabeleça as chaves

1. Emita o ID do grupo com POST /2/chat/conversations/group/initialize — o data.conversation_id da resposta é o ID prefixado com g que você usa em todos os passos a seguir.
2. Carregue a chave pública de identidade e o public_key_version de cada membro (rotas GET de chave pública em Chaves de criptografia; GET /2/users/public_keys busca vários usuários em uma única requisição). Verifique cada registro com verify_key_binding antes de usá-lo (veja o aviso em Guia de introdução).
3. Execute prepare_group_create uma vez, com todos os membros (incluindo você mesmo), o ID prefixado com g e as listas de IDs de membros/admins. Uma chamada gera a chave de conversa, envelopa-a para cada membro e assina a criação com a identidade da sessão de set_identity — ela retorna duas assinaturas de ação (a mudança de chave de conversa e a criação do grupo).
4. POST /2/chat/conversations/group com os members/admins do grupo, conversation_key_version, conversation_participant_keys (SDK encrypted_key → API encrypted_conversation_key) e ambas as action_signatures. Falhas de validação retornam mensagens estáveis e legíveis por humanos, por exemplo "Too many members: adding these members would exceed the allowed group size." ou "Cannot add all members: one or more of the requested members cannot be added to this conversation.".
5. Mantenha a chave de conversa em bruto e a versão para criptografar/descriptografar.

# chat has keys loaded and set_identity called (see Getting Started)
prepared = chat.prepare_group_create(
    member_public_keys,
    group_id,  # g-prefixed id from POST /2/chat/conversations/group/initialize
    member_ids, admin_ids, title="Project team",
)
# POST /2/chat/conversations/group with group_members, group_admins,
# conversation_key_version, conversation_participant_keys, and BOTH
# entries of prepared["action_signatures"]

// chat has keys loaded and setIdentity called (see Getting Started)
const prepared = chat.prepareGroupCreate({
  publicKeys: memberPublicKeys,
  conversationId: groupId, // g-prefixed id from POST /2/chat/conversations/group/initialize
  memberIds, adminIds, title: 'Project team',
});
// prepared.actionSignatures has two entries — send both

// chat has keys loaded and set_identity called (see Getting Started)
let mut params = GroupCreateParams::new(
    member_public_keys, &group_id, member_ids, admin_ids,
);
params.title = Some("Project team".into());
let prepared = chat.prepare_group_create(params)?;
// prepared.action_signatures has two entries — send both

// chat has keys loaded and SetIdentity called (see Getting Started)
prepared, err := chat.PrepareGroupCreate(chatxdk.GroupCreateParams{
    PublicKeys: memberPublicKeys, ConversationID: groupID,
    MemberIDs: memberIDs, AdminIDs: adminIDs, Title: "Project team",
})
// prepared.ActionSignatures has two entries — send both
_ = prepared
_ = err

// chat has keys loaded and SetIdentity called (see Getting Started)
var prepared = chat.PrepareGroupCreate(
    new GroupCreateParams(memberPublicKeys, groupId, memberIds, adminIds)
    {
        Title = "Project team",
    });
// prepared.ActionSignatures has two entries — send both

// chat has keys loaded and setIdentity called (see Getting Started)
GroupCreateParams params =
    new GroupCreateParams(memberPublicKeys, groupId, memberIds, adminIds);
params.title = "Project team";
PreparedConversationChange prepared = chat.prepareGroupCreate(params);
// prepared.actionSignatures has two entries — send both

​

Metadados de grupo criptografados

# Decrypt a field from the conversation object (name may vary by API shape)
group_name = chat.decrypt(conversation["group_name"], raw_conv_key)

# Encrypt before update if your API accepts ciphertext metadata
encrypted_name = chat.encrypt("Project team", raw_conv_key)

const groupName = chat.decrypt(conversation.groupName, rawConvKey);
const encryptedName = chat.encrypt('Project team', rawConvKey);

// conv_key: &XChatConversationKey from extract_conversation_keys / decrypt_conversation_key
let group_name = chat.decrypt(&conversation_group_name_b64, &conv_key)?;
let encrypted_name = chat.encrypt("Project team", &conv_key)?;

groupName, err := chat.Decrypt(conversationGroupNameB64, rawConvKey)
encryptedName, err := chat.Encrypt("Project team", rawConvKey)
_ = groupName
_ = encryptedName

string groupName = chat.Decrypt(conversationGroupNameB64, rawConvKey);
string encryptedName = chat.Encrypt("Project team", rawConvKey);

String groupName = chat.decrypt(conversationGroupNameB64, rawConvKey);
String encryptedName = chat.encrypt("Project team", rawConvKey);

​

Mensagens e eventos

• Enviar: encrypt_message → API de enviar mensagem (Guia de introdução)
• Receber: API de eventos ou entrega em tempo real → decrypt_event / decrypt_events
• Mídia: Mídia com o ID de conversa do grupo

​

Mudanças de chave de membros que saíram

• Apenas o material de chave que foi criptografado para sua chave de identidade pode ser recuperado — um terceiro não pode injetar uma chave que você consiga ler
• Cada mensagem ainda é verificada por assinatura contra seu próprio remetente, então a autoria das mensagens não é afetada

​

Checklist

1. Emita o ID prefixado com g com POST /2/chat/conversations/group/initialize
2. prepare_group_create com cada membro; POST dos envelopes de chave dos participantes e ambas as assinaturas de ação para POST /2/chat/conversations/group
3. Faça cache da chave em bruto + versão; atualize em eventos de mudança de chave
4. Em mudanças de composição, prepare_group_members_change (duas assinaturas) → POST /2/chat/conversations/{id}/members
5. Descriptografe metadados de grupo com decrypt quando os campos são texto cifrado
6. Envie/receba com os mesmos padrões do 1:1