You are viewing the Portuguese (Brazil) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Classifique esta página:

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.

Loading Code Sample...
        
        

        Enviar uma mensagem com um Messaging Service

        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

        Compatível com SMS? Compatível com WhatsApp?
        Sim Não

        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.

        O suporte para o envio de mensagens de um remetente alfanumérico depende do seu número de telefone de destino (To) e não está disponível em todos os locais. Consulte este artigo para obter a lista completa de 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

        Compatível com SMS? Compatível com WhatsApp?
        Sim Não

        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.

        O redirecionamento de short code não tenta entregar novamente sua mensagem por um long code devido a um status de entrega Failed (falhou) ou Undelivered (não entregue). Para essa funcionalidade, leia sobre o recurso Fallback para long code.

        Geomatch de código do país

        Compatível com SMS? Compatível com WhatsApp?
        Sim Sim

        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

        Compatível com SMS? Compatível com WhatsApp?
        Sim Sim

        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.

        Não deve ser incluído mais de um número gratuito no mesmo Pool de remetentes do Messaging Service. Isso pode resultar no bloqueio desse número.

        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

        Compatível com SMS?

        Compatível com WhatsApp?

        Sim Não

        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.

        Quando um número de telefone da Twilio é removido do Messaging Service, a Twilio exclui todos os mapeamentos do Sticky Sender associados ao número removido.

        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):

        Dynamically select a phone number with Twilio's Messaging Service

        Geomatch de código de área

        Compatível com SMS? Compatível com WhatsApp?
        Sim Não

        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.

        Esse recurso não está disponível fora dos EUA e do Canadá.

        Fallback para long code

        Compatível com SMS? Compatível com WhatsApp?
        Sim Não

        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.

        Observe que nem todas as mensagens undelivered são reenviadas usando um número de telefone long code. A entrega bem‐sucedida de mensagens por meio do long code também não é garantida.

        Você será cobrado pela mensagem de short code e pela segunda tentativa de mensagem com um número de telefone long code.

        Você só deve ativar a opção Fallback para long code se seus usuários finais tiverem optado por receber mensagens SMS de você. Todos os requisitos de conformidade da operadora e padrões do setor devem ser seguidos.

        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

        Compatível com SMS? Compatível com WhatsApp?
        Sim Sim

        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.

        O Período de validade da Twilio se aplica somente às mensagens enquanto elas trafegam pela plataforma da Twilio. Depois que a Twilio envia as mensagens para a rede da operadora, as operadoras ainda podem colocar as mensagens em fila, resultando em um tempo de envio que excede o Período de validade.

        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

        Compatível com SMS? Compatível com WhatsApp?
        Sim Sim

        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

        Compatível com SMS? Compatível com WhatsApp?
        Sim Não

        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.

        A Codificação inteligente não translitera mensagens que contenham emoji (😱) ou idiomas baseados em caracteres, como hangul coreano (안녕하세요). Consulte esta lista para obter os caracteres Unicode que a Codificação inteligente substituirá.

        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

        Compatível com SMS? Compatível com WhatsApp?
        Sim Não

        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).

        A Twilio cobra as mensagens convertidas como mensagens SMS. O URL anexado pode fazer com que o corpo da mensagem de texto seja maior que o número de caracteres por segmento para o sistema de codificação de caracteres (leia sobre GSM-7 e UCS-2). Nesse caso, a Twilio segmenta a mensagem e cobra de acordo.

        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.

        O Conversor de MMS envia links para arquivos de mídia via SMS onde a operadora receptora não é compatível com MMS. Ele não permite que você envie mídia se seu número de telefone From (De) não tiver recursos de MMS.

        Você pode verificar os recursos de números no console ou consultar o recurso Números de telefone disponíveis para procurar números da Twilio que estejam habilitados para MMS.

        Alerta de pré‐registro do ID do Remetente

        Compatível com SMS? Compatível com WhatsApp?
        Sim Não

        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.

        Embora esse recurso alerte sobre um possível problema de conformidade, ele não bloqueia nem impede que suas mensagens sejam enviadas.

        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

        Compatível com SMS? Compatível com WhatsApp?
        Sim Sim

        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.

        Classifique esta página:

        Precisa de ajuda?

        Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.

        Loading Code Sample...
              
              
              

              Obrigado pelo seu feedback!

              Selecione o(s) motivo(s) para seu feedback. As informações adicionais que você fornece nos ajudam a melhorar nossa documentação:

              Enviando seu feedback...
              🎉 Obrigado pelo seu feedback!
              Algo deu errado. Tente novamente.

              Obrigado pelo seu feedback!

              thanks-feedback-gif