Grupos do WhatsApp

Os Grupos do WhatsApp podem reunir vários participantes em uma conversa compartilhada. A API de Grupos atual da YCloud foca na configuração e gerenciamento de grupos. Confirme se esse escopo atende ao seu caso de uso antes de criar uma experiência baseada em grupos.

​

Verificar a elegibilidade do número

O guia de Grupos da YCloud atual exige uma Conta Comercial Oficial e um número compatível da Cloud API. Ele exclui números do aplicativo WhatsApp Business e Conversas com Múltiplas Soluções. Sua conta da YCloud deve ter acesso ao número. A disponibilidade de grupos permanece sujeita às verificações de elegibilidade da plataforma e da YCloud; ter apenas uma chave de API não torna um número elegível. O guia documenta pequenos grupos de até oito participantes. Consulte o guia atual antes de planejar a quantidade de grupos, limites de participantes ou outras suposições de capacidade.

​

O que a YCloud suporta

A API atual suporta:

• Criar, listar, recuperar e excluir grupos.
• Recuperar e redefinir links de convite.
• Enviar um modelo de mensagem aprovado com link de convite para um indivíduo.
• Listar, aprovar e rejeitar solicitações de entrada.
• Remover participantes.
• Atualizar o assunto e a descrição.
• Receber eventos de ciclo de vida, participantes, configurações e status do grupo.

O contrato OpenAPI da YCloud define as operações exatas. Ele distingue explicitamente o envio de um convite individual do envio de mensagens em grupo. Fonte: exemplo oficial da Meta.

​

A participação é um processo de convite

O cliente escolhe se deseja entrar por meio do convite. Se a aprovação for necessária, sua empresa analisa a solicitação de entrada. Não presuma que saber o número de telefone de uma pessoa autoriza adicioná-la a um grupo. Explique a finalidade do grupo e quem participará antes de compartilhar o link. Trate os links de convite como informações sensíveis ao acesso. Considere se um link irrestrito pode ser encaminhado além do público pretendido e defina quando redefini-lo.

​

Aguarde o resultado final

Algumas operações de gerenciamento são concluídas de forma assíncrona. A resposta imediata confirma o recebimento da solicitação; os webhooks relatam o resultado. Antes de enviar um convite, confirme se a criação do grupo foi bem-sucedida. Após uma alteração de membros, confirme os participantes afetados em vez de presumir que toda a solicitação foi bem-sucedida. Um evento de mensagem de grupo recebida pode ser capturado por uma integração mesmo que a Caixa de Entrada não exiba a conversa. Esse evento não concede suporte a mensagens de grupo enviadas.

​

Um fluxo de trabalho seguro para o primeiro grupo

1. Confirme o status de OBA do número de envio e a elegibilidade para Grupos.
2. Crie um grupo com um assunto claro e escolha a entrada automática ou a entrada sujeita a aprovação.
3. Armazene o ID da solicitação de criação. Uma resposta com status: "pending" não é o grupo final.
4. Aguarde o evento de ciclo de vida de criação bem-sucedida do grupo e armazene seu ID de grupo e link de convite.
5. Envie o modelo de mensagem aprovado com link de convite para os destinatários individuais elegíveis.
6. Se a aprovação for necessária, revise cada solicitação de entrada e aprove-a ou rejeite-a.
7. Confirme a participação a partir do resultado do participante antes de tratar a pessoa como membro.

Um convite entregue não significa que o destinatário abriu o link, solicitou acesso ou entrou. Se uma operação de aprovação retornar resultados mistos, processe cada resultado separadamente.

​

Identificadores e limites documentados

Trate um ID de grupo como um identificador opaco e que diferencia maiúsculas de minúsculas. Não o normalize nem o decodifique. Um ID de solicitação de criação, ID de grupo, ID de mensagem de convite e ID de solicitação de entrada são identificadores diferentes e não são intercambiáveis.

​

Proteger alterações de membros

Redefinir um link de convite invalida o link anterior. Atualize todos os convites ou pontos de distribuição controlados que ainda o utilizam; destinatários com o link antigo podem não conseguir mais entrar. Configure um endpoint de webhook da YCloud para atualizações de ciclo de vida, participantes, configurações e status do grupo. A YCloud gerencia a assinatura relevante na plataforma; seu aplicativo ainda precisa verificar as assinaturas do webhook e lidar com eventos duplicados de forma segura. Mantenha um registro de auditoria de quem solicitou uma ação, o grupo afetado, o ID da solicitação e o resultado final. Não registre links de convite privados em painéis públicos.

​

Decida se deseja prosseguir

Use o guia de integração de Grupos se as operações de gerenciamento suportadas atenderem às suas necessidades. Se o seu requisito principal for o envio de mensagens em grupo bidirecionais no YCloud Inbox ou por meio da Messages API, confirme a disponibilidade com a YCloud antes da implementação. Não assuma um compromisso com o cliente com base em um recurso não suportado.

​

Perguntas frequentes