Mensagens em grupo por MMS

As mensagens em grupo permitem que vários participantes troquem mensagens em uma conversa compartilhada. Ao contrário das mensagens individuais, as mensagens em grupo mantêm todos os participantes cientes de quem mais está na conversa, permitindo que respondam ao grupo e continuem a discussão.

Esse recurso é compatível apenas com o MMS. O protocolo SMS não oferece suporte à funcionalidade de mensagens em grupo.

O MMS em grupo foi projetado para pequenas discussões interativas em grupo, e não para casos de uso relacionados a transmissões ou marketing. Ele é particularmente adequado para números 10DLC.

Quando usar mensagens em grupo pelo MMS

O MMS em grupo é uma boa opção para situações em que uma empresa precisa facilitar uma conversa em tempo real entre várias pessoas.

Entre os casos de uso adequados estão:

  • Um agente de suporte que coordena simultaneamente um cliente e um especialista.
  • Um prestador de serviços mantém um cliente e um técnico de campo na mesma conversa.
  • Uma pequena equipe recebendo e respondendo a uma atualização compartilhada.

Envio de uma mensagem em grupo

O MMS em grupo é um recurso da Messages API e utiliza o endpoint padrão e as interações via webhook.

Para iniciar uma conversa em grupo, você envia uma mensagem separada para cada participante. Cada mensagem designa um membro do grupo como destinatário principal to e lista os participantes restantes na mms.participants matriz. Isso informa ao dispositivo de cada destinatário quem são os outros participantes da conversa, permitindo que eles respondam ao grupo.

Como cada mensagem precisa ser enviada individualmente a cada participante, cada mensagem é cobrada como uma mensagem MMS separada.

O participants a matriz é colocada dentro do mms nó do corpo da solicitação.

Exemplo: Envio para um grupo de três pessoas

Mensagem para o destinatário 1

{
  "message_type": "text",
  "text": "Hello from Vonage",
  "from": "11234567890",
  "to": "11234567891",
  "mms": {
    "participants": [
      "11234567892",
      "11234567893"
    ]
  },
  "channel": "mms"
}

Mensagem para o destinatário 2

{
  "message_type": "text",
  "text": "Hello from Vonage",
  "from": "11234567890",
  "to": "11234567892",
  "mms": {
    "participants": [
      "11234567891",
      "11234567893"
    ]
  },
  "channel": "mms"
}

Mensagem para o destinatário 3

{
  "message_type": "text",
  "text": "Hello from Vonage",
  "from": "11234567890",
  "to": "11234567893",
  "mms": {
    "participants": [
      "11234567891",
      "11234567892"
    ]
  },
  "channel": "mms"
}

Recebimento de respostas em grupo

Quando um participante responde ao grupo, a mensagem recebida é enviada ao seu webhook. A carga útil do webhook inclui o mms.participants matriz, identificando os demais participantes da conversa.

Exemplo: Webhook de entrada do destinatário 1

{
  "channel": "mms",
  "message_uuid": "aaaaaaaa-bbbb-4ccc-8ddd-0123456789fa",
  "from": "11234567891",
  "to": "11234567890",
  "timestamp": "2025-10-03T12:15:25Z",
  "origin": {
    "network_code": "12345"
  },
  "message_type": "text",
  "text": "Hello to the group!",
  "mms": {
    "participants": [
      "11234567892",
      "11234567893"
    ]
  }
}

Disponibilidade e Cobertura

País Tipo numérico Notas
US 10DLC Compatível com qualquer número 10DLC.
US Código curto Os códigos curtos podem exigir uma configuração adicional. Entre em contato com seu gerente de conta ou Suporte para pedir ajuda.

Mais informações