Mensagens RCS via Twilio

As mensagens RCS (Rich Communication Services) chegam ao aplicativo de mensagens nativo do telefone como um chat da sua marca, com o seu logotipo e um card, um carrossel, mídia ou botões em vez de texto simples. O Pushwoosh as envia pela Twilio como parte do canal de SMS.

Nota

A configuração leva tempo: segundo a Twilio, as operadoras aprovam um remetente RCS em 4 a 6 semanas ou mais por país, então comece o registro cedo.

Como funciona

Uma mensagem RCS vai de um template da Twilio até o telefone em três etapas:

1. Você cria a mensagem como um content template na Twilio.
2. Você escolhe o template em um preset de SMS. Cada idioma do preset pode ter o seu próprio template.
3. Quando o preset é enviado, a Twilio tenta entregar o template via RCS. Os telefones que não podem receber RCS recebem um SMS em seu lugar, conforme descrito em Fallback para SMS.

Se você escolher um template apenas para alguns idiomas do preset, os demais idiomas não são enviados via RCS. Eles saem como um SMS comum com o texto do respectivo campo Mensagem.

Fallback para SMS

O fallback para SMS é o que os telefones sem RCS recebem no lugar da mensagem RCS. Se o telefone ou a operadora do destinatário não for compatível com RCS, a Twilio envia um SMS gerado a partir do tipo Text do template.

O fallback para SMS vem do template, não do campo Mensagem do preset. Se o template não tiver o tipo Text, os telefones sem RCS não recebem a mensagem.

O que você precisa para enviar RCS

O RCS funciona apenas pela sua própria conta Twilio, com um Messaging Service e um remetente RCS aprovado pelas operadoras.

• Twilio como provedor de SMS. Conecte-a com o seu próprio Account SID e Auth token da Twilio. Se o Pushwoosh fornecer o número e as credenciais da Twilio para o seu projeto, o RCS não fica disponível, e esses envios são rejeitados.
• Um Messaging Service da Twilio. O seu sender pool contém um remetente RCS e um número de SMS. O SID dele vai em Messaging Service SID nas configurações da plataforma de SMS. Sem ele, o envio de uma mensagem com template falha.
• Um número From. Defina-o nas configurações da plataforma de SMS como o número de SMS do pool do Messaging Service. O Pushwoosh não envia SMS pela Twilio sem ele, mesmo quando um Messaging Service está definido.
• Um remetente RCS aprovado pelas operadoras nos países para os quais você envia. A Twilio cuida do registro. Segundo a Twilio, ele leva de 4 a 6 semanas ou mais por país.

Configurar o RCS na Twilio

Estas etapas são feitas no Twilio Console. Os nomes dos menus seguem o guia de onboarding de RCS da Twilio e podem variar um pouco no seu console.

Criar um remetente RCS

O remetente RCS é o perfil da marca que os destinatários veem no chat: o seu nome, logotipo e cores.

1. Vá para Communications → Numbers & senders → Overview → RCS.

2. Clique em Create RCS Sender.

3. Insira um Sender display name.

4. Aceite os termos e clique em Continue.

5. Em Public details, preencha todos os campos:

   • Display name e Description.
   • Logo image (224×224 px, até 50 KB) e Banner image (1440×448 px, até 200 KB), como URLs públicas de JPG ou PNG.
   • Accent color com uma taxa de contraste de pelo menos 4,5:1 em relação ao branco, por exemplo #1A73E8.
   • Um telefone ou e-mail de contato, uma Privacy policy URL e uma Terms of service URL.

6. Clique em Next.

Adicionar um telefone de teste

Até que as operadoras aprovem o remetente, ele entrega mensagens apenas para telefones de teste.

1. Em Try it out, clique em Add device to test this sender.
2. Insira um número de telefone Android em formato internacional e clique em Invite.
3. No telefone, abra o convite no Google Messages e toque em Make me a tester.
4. No console, confirme que o proprietário aceitou o convite.
5. Envie uma mensagem a partir de Your message. Ela deve chegar como um chat da sua marca com o logotipo, e não como um SMS.

Registrar o remetente nas operadoras

A Twilio só adiciona um remetente RCS a um Messaging Service depois que pelo menos uma operadora o aprova, então comece o registro antes de criar o Messaging Service.

1. No remetente RCS, abra Compliance registration.
2. Clique em Add countries.
3. Selecione os países para os quais você envia e clique em Save countries.
4. Clique em Start.
5. Preencha o formulário e clique em Submit registration. Para os EUA, a Twilio tem um formulário separado, US registration.

O status do registro aparece como Pending Review até que as operadoras o aprovem.

Criar um Messaging Service

O Messaging Service agrupa o remetente RCS e um número de SMS, para que a Twilio possa escolher RCS ou SMS para cada telefone.

1. Vá para Messaging → Services.
2. Crie um serviço.
3. Em Sender Pool, adicione um número da Twilio com suporte a SMS. Sem ele, os telefones sem RCS não recebem nada.
4. Assim que pelo menos um país mostrar Approved em Compliance registration, adicione o remetente RCS ao Sender Pool.
5. Copie o SID do serviço. Ele começa com MG.

Criar um content template

O content template define a mensagem RCS e o seu fallback para SMS.

1. Vá para Messaging → Content Template Builder.
2. Clique em Create new.
3. Escolha um tipo compatível com RCS: Card, Carousel, Quick reply, Call to action ou Media.
4. Preencha o conteúdo. Para um valor que muda por destinatário, use uma variável numerada, por exemplo {{1}} para o primeiro nome no título do card.
5. Para ramificar uma jornada com base na resposta, adicione botões de resposta rápida e dê um ID a cada um. Não use default nem um ID que comece com output: esse botão não recebe ramificação na jornada.
6. Adicione o tipo Text ao mesmo template. A Twilio gera o fallback para SMS a partir dele.
7. Salve o template.

Conectar a Twilio no Pushwoosh

O Pushwoosh envia RCS com as credenciais da Twilio e o Messaging Service que você insere nas configurações da plataforma de SMS.

1. Vá para Configurações → Configurar Plataformas.

2. Abra SMS.

3. Defina o provedor de SMS como Twilio.

4. Preencha os campos:

   • From number: o número de SMS do pool do Messaging Service.
   • Account SID e Auth token: as credenciais da conta Twilio dona do remetente RCS e dos templates.
   • Messaging Service SID (optional): o SID MG do Messaging Service. O campo é opcional para SMS, mas o RCS precisa dele.

5. Clique em Aplicar.

Para o restante das configurações de SMS, veja Configuração da plataforma de SMS. Os status de entrega das mensagens RCS não precisam de configuração de webhook, porque o Pushwoosh envia a URL de status callback para a Twilio junto com cada mensagem.

Receber respostas

As respostas às mensagens RCS chegam ao Pushwoosh apenas por um webhook que você define no remetente RCS.

1. No Twilio Console, abra o remetente RCS e vá para Configuration.
2. Defina Webhook URL for incoming messages como a URL de SMS recebidos de Webhooks do provedor de SMS, com o método POST.
3. Clique em Save configuration.

O Pushwoosh trata uma resposta RCS da mesma forma que uma resposta SMS. Ele dispara o evento PW_SMSReceived para o número de telefone do remetente, e uma resposta STOP define a tag de consentimento de marketing do assinante como false. Veja Consentimento de marketing para SMS e Viber.

Enviar uma mensagem RCS

Uma mensagem RCS é enviada sempre que você envia um preset de SMS que tem um template.

1. Abra ou crie um preset de SMS.
2. Escolha um template da Twilio para cada idioma no bloco RCS, conforme descrito em Enviar via RCS.
3. Envie o preset em uma campanha de SMS ou em uma Customer Journey.

Em uma jornada, um elemento SMS com um template de resposta rápida recebe uma ramificação para cada botão e espera até 24 horas por um toque. Veja Ramificar por botões de resposta RCS.

Verificar as estatísticas de RCS

Para ver quantas entregas foram confirmadas via RCS, quantas chegaram como SMS e qual parcela dos destinatários de RCS leu a mensagem, abra as estatísticas da mensagem do envio.