Skip to main content

Grupos do WhatsApp

O Switchbord agora inclui a primeira base para conversas em grupo do WhatsApp. A caixa de entrada pode marcar conversas como grupos, exibir resumos de grupo e filtrar a lista de conversas para Grupos, voltado a testes internos da equipe.
Esta é uma camada de base. Ela ainda não oferece gerenciamento completo do ciclo de vida do grupo, gerenciamento de participantes ou aplicação completa das regras de envio em grupo.

Restrições da Meta Groups API

A Groups API da Meta tem restrições diferentes das mensagens padrão um a um pela Cloud API:
  • As empresas precisam ter uma Conta Comercial Oficial (OBA) para usar os recursos da Groups API.
  • Os grupos são apenas por convite, e os participantes entram por meio de um link de convite de grupo.
  • Máximo de participantes por grupo: 8.
  • Os tipos de mensagem suportados incluem texto, mídia, templates baseados em texto e templates baseados em mídia.
  • Experiências não suportadas incluem Calling API, mensagens que desaparecem, mensagens de visualização única, mensagens de autenticação, mensagens de comércio e mensagens interativas.
  • As análises de template não estão disponíveis para templates usados em grupos; crie templates separados para uso em grupo.

Suporte atual do Switchbord

A base da v0.15.53 adiciona:
  • Resumos de domínio Conversation.isGroup e Conversation.group.
  • Detecção de grupo baseada em metadados a partir de conversations.metadata (chatType, conversationType, type ou isGroup).
  • Um filtro (pill) exclusivo para Grupos em /inbox, ao lado dos filtros existentes na lista de conversas.
  • Suporte no lado do servidor para groupsOnly=1 em /api/inbox/conversations.
  • Um índice de metadados do Supabase para descoberta de conversas em grupo.
  • Dados fictícios de grupo interno da equipe para QA inicial.

Formato recomendado de metadados

Até que uma tabela dedicada de grupos seja implementada, as conversas em grupo devem carregar metadados semelhantes a:
Evite retornar links de convite em respostas amplas da lista da caixa de entrada, a menos que a ação do operador realmente precise deles.

Limitações atuais

  • A caixa de entrada consegue filtrar e identificar grupos, mas o painel de detalhes selecionado ainda precisa de um refinamento na apresentação voltada a grupos.
  • As restrições de envio específicas de grupo ainda não estão totalmente aplicadas.
  • O gerenciamento da lista de participantes não está implementado.
  • A criação/renovação de links de convite não está implementada.
  • Templates e análises de grupo devem ser separados dos templates de campanha um a um.

Checklist de implementação de acompanhamento

  1. Destacar o nome do grupo, o id do grupo e a contagem de participantes na linha da lista, no cabeçalho e no painel de detalhes lateral.
  2. Adicionar proteções de envio específicas de grupo para tipos de mensagem não suportados.
  3. Adicionar importação/sincronização de grupo a partir da Meta Groups API, uma vez confirmada a elegibilidade de OBA.
  4. Adicionar gerenciamento de participantes e ações de link de convite protegidos por permissões explícitas.
  5. Adicionar testes usando o grupo interno da equipe como o primeiro alvo de QA em produção.