Serviços de mensagens

O envio de um grande volume de mensagens nos Estados Unidos e em todo o mundo torna‐se complexo. À medida que a complexidade do seu aplicativo de mensagens aumenta, é útil organizar sua conta e os logs de mensagens em Messaging Services separados usando o Twilio Programmable Messaging.

Um Messaging Service pode ser visto como um “agrupamento” de nível superior da funcionalidade de mensagens em torno de um conjunto comum de remetentes, recursos e configurações. As mesmas definições e configurações de recursos são aplicadas a todos os remetentes (números long code, short code, números gratuitos etc.) no pool do Messaging Service.

Os recursos de um Messaging Service podem ser gerenciados e configurados diretamente pelo Console, bem como usando a API REST.

Para cada Messaging Service adicionado pelo console, você começará configurando o Inbound Request e os Status Callback URLs. Você também precisará associar um ou mais números de telefone ou short codes ao Serviço para enviar mensagens. Você pode incluir recursos de mensagens adicionais (descritos abaixo) ao seu aplicativo por meio do Messaging Service recém‐configurado.

Enviar uma mensagem com um Messaging Service

Se você usar um Messaging Service para enviar uma mensagem, sua solicitação à Twilio será muito semelhante a enviar um SMS com a API REST. No entanto, em vez de incluir um número de telefone em From (De), você incluirá um MessagingServiceSid. A Twilio escolherá um dos números de telefone no pool de remetentes do Messaging Service com base na configuração do serviço.

Ao enviar uma mensagem com um Messaging Service, a Twilio definirá imediatamente o status da mensagem para accepted. A Twilio determinará então o número de telefone em From (De) ideal a partir do seu serviço. Erros de entrega serão enviados de forma assíncrona para seu StatusCallbackURL.

Usar o WhatsApp com Messaging Services

Você pode adicionar um número de telefone da Twilio habilitado para WhatsApp a outros tipos de remetente (long codes, short codes etc.) em seu Pool de remetentes do Messaging Service. Dessa forma, você pode configurar e aplicar os recursos relevantes do Messaging Service, como definir um período de validade, para todos os tipos de remetente em um Serviço, tudo de uma só vez. Nas descrições de recursos abaixo, incluímos a informação sobre se o recurso é compatível com SMS e WhatsApp.

Para incluir o WhatsApp em seu Pool de remetentes, no Console da Twilio, navegue até a seção Messaging (Mensagens) > Services (Serviços) e selecione um Messaging Service. No Sender Pool (Pool de remetentes) desse Serviço, você pode Add Senders (Adicionar remetentes) e especificar o número da Twilio habilitado para WhatsApp que deseja incluir.

Para obter mais informações sobre como configurar a WhatsApp Business API com a Twilio, leia Conecte seu número Twilio ao seu perfil do WhatsApp Business.

Recursos prontos para uso do Messaging Service

Os Messaging Services foram projetados para ajudar você a dimensionar as mensagens do seu aplicativo desde o primeiro SMS até as mensagens enviadas globalmente, em vários idiomas, de mais do que apenas números de telefone long code.

Ao criar seu Messaging Service, os seguintes recursos serão aplicados automaticamente.

Alpha Sender

Os IDs alfanuméricos do remetente são usados para mensagens unidirecionais da marca. Você pode adicionar um ID alfanumérico do remetente ao seu Pool de remetentes para habilitar esse recurso.

Com o Alpha Sender, você pode enviar suas mensagens a clientes de um remetente personalizado. Em vez de usar um número de telefone da Twilio no formato E.164 para o valor From (De), você pode usar uma string personalizada como a marca de sua própria empresa. Os IDs alfanuméricos do remetente podem ser usados sem custo adicional ao enviar um SMS para países compatíveis com esse recurso.

Se você adicionar um remetente alfanumérico ao Messaging Service da Twilio, a Twilio selecionará automaticamente o ID alfanumérico do remetente quando você enviar uma mensagem para um país compatível, a menos que você também tenha um número short code nesse mesmo país.

Para adicionar um ID alfanumérico do remetente a um Messaging Service, acesse os Messaging Services no console da Twilio. Selecione o serviço ao qual deseja adicionar um remetente alfanumérico e, na seção Senders (Remetentes), clique no botão Add Senders Ids (Adicionar IDs de remetentes). No menu suspenso a seguir, selecione Alpha Sender (Remetente alfanumérico) e insira o ID alfanumérico do remetente que você deseja adicionar ao Pool de remetentes.

Para saber mais sobre os IDs alfanuméricos do remetente, consulte o artigo de suporte sobre como começar a usar o ID alfanumérico do remetente.

Redirecionamento de short code

Quando o Pool de remetentes do Messaging Service inclui um short code, a Twilio sempre prioriza a entrega de mensagens usando esse short code. Se uma operadora não for compatível com um short code da Twilio, a Twilio enviará automaticamente a mensagem com um long code em seu Messaging Service.

A Twilio aplica automaticamente o redirecionamento de short code para mensagens enviadas pelo Messaging Service. Este não é um recurso que pode ser ativado ou desativado.

Geomatch de código do país

Ao enviar mensagens internacionais, o recurso Geomatch do país seleciona automaticamente o número de telefone da Twilio em seu Messaging Service para corresponder ao país do número de telefone do destinatário. Se o seu Serviço não incluir um número de telefone da Twilio para o mesmo país do destinatário, a Twilio primeiro tentará selecionar um número de telefone dos EUA habilitado para SMS antes de selecionar outro número para entregar a mensagem. A mensagem falhará se seu Serviço não tiver números de telefone disponíveis para entregá‐la.

Você pode usar Geomatch do código do país adicionando números de telefone ao seu Messaging Service que correspondam aos países dos seus destinatários.

Quando um número de telefone de um novo país geográfico é adicionado ao seu Messaging Service, a Twilio seleciona e remapeia automaticamente qualquer mapeamento existente do Sticky Sender para que o número From (De) corresponda ao mesmo país que o número de telefone do destinatário.

Scaler

O recurso Scaler distribui o tráfego de mensagens de saída de maneira uniforme pelos números de telefone no Messaging Service para que você possa lidar com volumes maiores de mensagens. Quando o Messaging Service envia uma mensagem, ele seleciona o número From (De) do seu pool de números que não estão sendo usados no momento para enviar outras mensagens.

Quando o Sticky Sender está ativado, o Messaging Service prioriza qualquer mapeamento do Sticky Sender existente. Em seguida, ele seleciona o próximo número de telefone disponível no Pool de remetentes do Serviço que tem o menor número de mapeamentos.

Recursos configuráveis dos Messaging Services

Além da funcionalidade básica do Messaging Service discutida acima, há vários recursos mais avançados que você pode usar para gerenciar os remetentes do seu Serviço, a integração com seu aplicativo, o conteúdo de mensagens, a conformidade, as palavras‐chave de opt-out e muito mais.

Você pode ativar esses recursos e alterar suas configurações no Console da Twilio.

Sticky Sender

O recurso Sticky Sender garante que o mesmo número de telefone From (De) seja selecionado sempre que o aplicativo enviar uma mensagem a um usuário final específico. Isso permite que seu aplicativo envie mensagens de forma consistente ao usuário a partir de um único número de telefone reconhecível.

Com o Sticky Sender ativado, a Twilio mantém um mapeamento de todos os números de telefone To (Para) e From (De) que o seu Messaging Service usou e com os quais interagiu. A Twilio cria um novo mapeamento depois de enviar a primeira mensagem do Messaging Service para um usuário final específico. Todas as mensagens futuras enviadas a esse destinatário a partir do Serviço também usarão o mesmo número From (De).

Se o Sticky Sender estiver desativado, o Messaging Service ignorará todos os mapeamentos estabelecidos anteriormente. No entanto, se você ativá‐lo novamente no futuro, seu Messaging Service manterá e fará referência aos mapeamentos pré‐existentes.

Como ativar o Sticky Sender

Na seção Sender Pool (Pool de remetentes) de seu Messaging Service, expanda a caixa Sender Selection Settings (Configurações de seleção de remetentes) . A partir daí, você pode ativar ou desativar o recurso Sticky Sender.

Seleção inteligente de números em um Messaging Service

Quando o Sticky Sender está ativado, o Messaging Service segue a lógica abaixo para determinar o número de telefone ideal como o número from (de):

Geomatch de código de área

Ao enviar mensagens para os Estados Unidos e Canadá, o recurso Geomatch de código de área seleciona um número de telefone local com um código de área que corresponde ou é uma sobreposição do número do usuário final.

Se um código de área de sobreposição ou correspondente não estiver disponível, o Messaging Service selecionará outro número de telefone dos EUA ou do Canadá em seu Messaging Service. A proximidade geográfica não é levada em consideração na seleção de um número de telefone.

Como ativar o Geomatch de código de área

Na seção Senders (Remetentes) do seu Messaging Service, expanda a caixa Sender Selection Settings (Configurações de seleção de remetentes). A partir daí, você pode ativar ou desativar o recurso Geomatch de código de área.

Fallback para long code

O recurso Fallback para long code tenta novamente a entrega de mensagens usando um número de telefone long code quando certas mensagens enviadas com um short code não são entregues com êxito.

Ao enviar uma mensagem, o Messaging Service prioriza a entrega de mensagens com um short code, se houver. No entanto, a mensagem de short code pode ter um status undelivered se o usuário final não puder receber mensagens desse tipo. Nesse caso, o Messaging Service tenta novamente enviar a mensagem usando um número de telefone long code do Pool de remetentes do Serviço.

Como ativar o Fallback para long code

Na seção Senders (Remetentes) do seu Messaging Service, expanda a caixa Sender Selection Settings (Configurações de seleção de remetentes). A partir daí, você pode ativar ou desativar o recurso Fallback para long code.

Período de validade

O Período de validade refere‐se ao número de segundos que as mensagens enviadas do Messaging Service permanecerão na plataforma da Twilio. Se o envio da mensagem exceder o Período de validade, haverá uma falha e a Twilio enviará uma solicitação ao URL de retorno de chamada de status para notificar seu aplicativo sobre a falha.

Como ativar o Período de validade

Na seção Integration (Integração) do seu Messaging Service, você pode inserir o tempo máximo da fila, em segundos, na caixa Validity period (Período de validade).

Você pode definir o Período de validade entre 1 e 14.440 segundos (no máximo quatro horas).

Tratamento de mensagens recebidas

Por padrão, os Messaging Services são definidos para Descartar mensagens recebidas. Se quiser realizar ações em cada mensagem, poderá configurar para enviar um webhook sempre que receber uma mensagem por meio de um número no pool de números do Messaging Service. Você também pode alterar o comportamento para criar automaticamente uma nova Conversa; há mais sobre esse recurso em Controle e criação automática de mensagens recebidas em Conversations.

Como ativar o Tratamento de mensagens recebidas

Na seção Integration (Integração) do seu Messaging Service, você pode atualizar como ele lida com mensagens recebidas. Esteja ciente de que o uso da opção Create new Conversation (Criar nova conversa) requer alterações adicionais de configuração na seção Conversations (Conversas) do Console da Twilio.

Codificação inteligente

O recurso Codificação inteligente do Messaging Service detecta caracteres Unicode fáceis de perder e os substitui por um caractere semelhante codificado por GSM. Isso ajuda a garantir que sua mensagem seja segmentada com 160 caracteres e evita que você envie dois segmentos de mensagem, o que aumenta seu gasto.

Por exemplo, às vezes um caractere Unicode, como aspas inteligentes ( 〞), travessão (—) ou um espaço em branco Unicode, acidentalmente entra na mensagem de 125 caracteres cuidadosamente criada. Agora, sua mensagem é segmentada e tem o preço de duas mensagens em vez de uma.

Quando caracteres Unicode são usados em uma mensagem SMS, eles devem ser codificados como UCS-2. No entanto, os caracteres UCS-2 levam 16 bits para codificar, portanto, quando uma mensagem inclui um caractere Unicode, ela será dividida ou segmentada entre o 70o e 71o caractere. Este é mais curto do que o segmento de 160 caracteres por mensagem que você obtém com a codificação de caracteres GSM-7.

Como ativar a Codificação inteligente

Na seção Content Settings (Configurações de conteúdo) do Messaging Service, você pode ativar ou desativar o recurso Codificação inteligente para mensagens SMS.

Conversor de MMS

O recurso Conversor de MMS entrega automaticamente sua mensagem MMS como uma mensagem de texto SMS. Essa mensagem SMS (texto) contém um URL abreviado que se vincula à sua imagem quando a operadora não é compatível com o recebimento de mensagens MMS da Twilio. O Conversor de MMS acrescenta o link do URL abreviado (http://m.twil.io/ seguido por sete caracteres exclusivos) ao final do corpo da mensagem; esse link permanece ativo por 365 dias (um ano).

Como ativar o Conversor de MMS

Você pode ativar ou desativar o recurso Conversor de MMS na seção Content Settings (Configurações de conteúdo) do seu Messaging Service.

Alerta de pré‐registro do ID do Remetente

O recurso Alerta de pré‐registro do ID do Remetente alerta automaticamente quando você envia mensagens a países que exigem IDs de remetente pré‐registrados. Alguns países que dão suporte a IDs alfanuméricos do remetente exigem o pré‐registro do ID do Remetente antes do uso.

Para ajudar você a permanecer em conformidade, ative o Alerta de pré‐registro do ID do remetente à medida que dimensiona o tráfego de mensagens. Depois de ativado, esse recurso emite avisos quando você envia tráfego de mensagens não registradas em países onde o registro é recomendado ou exigido. Você pode encontrar os alertas na seção Debugger do Console da Twilio.

Como ativar o alerta de pré‐registro do ID do remetente

Você pode ativar ou desativar o recurso Alerta de pré‐registro do ID do remetente na seção Compliance (Conformidade) do seu Messaging Service.

Opt-out avançado

O recurso Opt-out avançado permite que você ofereça uma experiência de conformidade personalizada e completa para seus usuários. Você pode definir as palavras‐chave e mensagens de confirmação de opt-in, opt-out e ajuda em uma base global, bem como adicionar substituições por idioma e por país. Por exemplo, você pode personalizar a mensagem que seus usuários finais receberão se responderem com "STOP" em inglês ou com "AYUDA" em espanhol.

Além disso, a opção Opt-out avançado oferece uma visão mais aprofundada do desempenho da sua campanha e do engajamento do usuário com o seu Messaging Service. Quando um usuário aciona uma de suas palavras‐chave de opt-in, opt-out ou ajuda, a Twilio inclui o OptOutType na solicitação para o seu URL de webhook configurado, para que você possa acompanhar a integridade de suas campanhas.

Como ativar a opção Opt-out avançado

Na seção Opt-Out Management (Gerenciamento de opt-out) de seu Messaging Service, é possível ativar o Opt-out avançado, bem como personalizar todas as mensagens de confirmação e palavras‐chave para interações de opt-out, opt-in e ajuda com seus usuários finais.

Recomendamos que você leia o guia para personalizar a experiência de opt-in e opt-out dos usuários com o Opt-out avançado para garantir que você configure esse recurso adequadamente para suas necessidades de mensagens.