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

Menu

Expand
Rate this page:

Visão geral da WhatsApp Business API with Twilio

A Twilio está lançando um novo Console. Algumas capturas de tela nesta página podem mostrar o Console legado e, portanto, podem não ser mais precisas. Estamos trabalhando para atualizar todas as capturas de tela para refletir a nova experiência do Console. Saiba mais sobre o novo Console.

O suporte da Twilio para a API do WhatsApp Business agora está disponível no mercado! Leia mais no Registro de alterações.

WhatsApp é o aplicativo OTT mais popular em muitas partes do mundo. Com a WhatsApp Business API with Twilio, você pode alcançar mais de 1,5 bilhão de usuários do WhatsApp. Você pode enviar notificações, ter conversas bidirecionais ou criar chatbots. Se você está tentando alcançar e conversar melhor com usuários na América Latina, EMEA e APAC, você precisa considerar o uso do WhatsApp.

Requisitos de Opt-in para WhatsApp

O WhatsApp requer que seu aplicativo implemente opt-ins explícitos de usuários para entregar mensagens pelo WhatsApp. Você pode coletar essas informações de opt-in por meio de uma página da web ou de um aplicativo móvel, por exemplo durante o fluxo de inscrição do aplicativo, nas configurações da conta do aplicativo, via SMS etc.

Observe que o envio de mensagens aos usuários finais sem um opt-in pode resultar no bloqueio de seus negócios por parte dos usuários, bem como na suspensão de sua conta WhatsApp Business.

Como usar números de telefone da Twilio com o WhatsApp

No WhatsApp, os usuários enviam mensagens uns aos outros usando números de telefone. Para enviar e receber mensagens do WhatsApp usando a API do Twilio Programmable Messaging, você também precisará de um número de telefone. A API da Twilio aborda os usuários do WhatsApp e seus números, usando o seguinte formato de endereço prefixado:

whatsapp:<E.164 formatted phone number>

(E.164 é um formato de número de telefone internacional. Você o verá frequentemente nas strings que representam os números de telefone da Twilio.)

Como ativar o WhatsApp com um número da Twilio

Para usar as mensagens do WhatsApp em aplicativos de produção, você deve ativar o WhatsApp no seu número da Twilio. O WhatsApp está atualmente abrindo esse acesso em um programa de disponibilidade limitada. Isso significa que a aprovação do WhatsApp é necessária para todos os clientes que desejam criar seus próprios perfis.

Para obter um passo a passo do processo, visite nosso guia para Conectar seu número da Twilio ao seu perfil do WhatsApp Business. Uma vez que sua solicitação foi enviada e aprovada, você poderá selecionar seus números da Twilio e solicitar que eles sejam ativados no WhatsApp.

Observação: no momento, não conseguimos ativar o WhatsApp em números não Twilio.

Envie sua conta do Facebook Business Manager

O WhatsApp usa sua conta do Facebook Business Manager para identificar sua empresa e associar seus números de telefone a ela.

Você deve obter aprovação para ativar seus números Twilio para WhatsApp. Em seguida, você precisará fornecer à Twilio seu ID do Facebook Business Manager. Se você ainda não tiver uma conta do Facebook Business Manager, siga as instruções do Facebook para criar uma.

Seu ID do Facebook Business Manager pode ser encontrado na seção "Business Info" em Configurações comerciais.

BM.png

Gerencie e configure seus números Twilio habilitados para WhatsApp

Você pode solicitar a configuração de até 25 novos números para o WhatsApp. Para gerenciar seus próprios modelos e seu perfil WhatsApp, vá até Messaging > Senders > Remetentes do WhatsApp no Console. Aqui você pode ver a lista de seus números de telefone (remetentes) Twilio habilitados para WhatsApp, bem como todos os modelos que você enviou para aprovação.

List of WhatsApp Senders

Ao clicar em um determinado remetente (número de telefone habilitado para WhatsApp) você será levado especificamente à página de configuração dele. Isso inclui a seção de configuração de endpoint, na qual você pode especificar qual ação a Twilio deve realizar quando receber uma mensagem WhatsApp nesse número. Você pode configurar esse remetente como parte de um Serviço de mensagens ou com um URL de webhook individual.

Configure an Individual Sender

Como enviar notificações com WhatsApp

O WhatsApp requer que as notificações iniciadas pela empresa enviadas pelo seu aplicativo sejam enviadas em um modelo e pré-registradas, com exceção das mensagens enviadas como resposta a uma mensagem iniciada pelo usuário. (Consulte Mensagens de conversa no WhatsApp para obter mais detalhes).

Para saber mais, consulte nosso Guia para enviar notificações WhatsApp usando modelos de mensagem.

Mensagens de conversa no WhatsApp

Para ter conversas bidirecionais com usuários finais, você precisa ser capaz de receber mensagens deles. Os usuários podem enviar suas mensagens comerciais diretamente ou em resposta a uma notificação modelo.

Como iniciar uma "24-hour Session" do WhatsApp

Uma sessão do WhatsApp começa quando um usuário envia uma mensagem para o seu aplicativo. As sessões são válidas por 24 horas após a mensagem recebida mais recentemente, período em que você pode se comunicar com os clientes usando mensagens de formato livre. Para enviar uma mensagem fora da janela de sessão de 24 horas, você deve usar um modelo de mensagem pré-aprovado. (Consulte nosso Guia para modelos de mensagens WhatsApp).

Configurar webhooks de mensagens de entrada

Quando os clientes enviam a você uma mensagem WhatsApp, a Twilio envia um webhook (uma solicitação para um URL que você especificar) para seu aplicativo. Você pode configurar o URL para o qual a Twilio envia um webhook quando recebe mensagens de entrada no Twilio Console:

Como configurar URLs de fallback para seus remetentes habilitados para WhatsApp

Opcionalmente, você pode configurar um URL de fallback no mesmo local em que definiu o URL padrão do webhook. Se ocorrer um erro fatal ao fazer uma solicitação ao URL principal do webhook, a Twilio "falls back" para este URL de fallback secundário.

Ao fazer a solicitação para o URL de fallback, a Twilio também envia os parâmetros ErrorCode e ErrorUrl indicando o código de erro da falha e o URL para o qual a falha ocorreu.

whasapp-sandbox-inbound-webhook.png
Configure WhatsApp Sender
Como configurar webhooks de mensagens de entrada para o sandbox da Twilio para WhatsApp Como configurar webhooks de mensagens de entrada para seu número Twilio habilitado para WhatsApp

Para obter detalhes sobre os dados fornecidos na solicitação que a Twilio faz para seu aplicativo (via URL do webhook), leia mais sobre as solicitações HTTP da Twilio para seu aplicativo.

Como receber mensagens do WhatsApp

O webhook para mensagens de entrada usa o mesmo formato que mensagens SMS e MMS recebidas, com a exceção de que os endereços To e From serão definidos para endereços WhatsApp (whatsapp:<your E.164 number> e whatsapp:<User's E.164 phone number>), respectivamente.

As mensagens recebidas podem incluir texto ou mídia. O campo Body contém a mensagem de texto e o campo MediaUrl0 contém um link para o arquivo de mídia. Você pode aprender a baixar mídia recebida junto com uma mensagem no tutorial de como receber e baixar imagens em mensagens MMS recebidas. As mídias compatíveis incluem imagens (JPG, JPEG, PNG), arquivos de áudio e arquivos PDF, com um limite de tamanho de 16 MB por mensagem.

Como responder a mensagens recebidas com TwiML

As mensagens de entrada do WhatsApp são totalmente compatívels com o TwiML, permitindo que você use perfeitamente seu app de SMS existente com o WhatsApp. Para obter mais informações, consulte a Documentação sobre como usar o TwiML.

Como enviar uma mensagem de WhatsApp de formato livre usando a API

Em uma sessão do WhatsApp, você pode enviar mensagens de formato livre usando a API Programmable Messaging. As mensagens de formato livre podem incluir texto ou mídia.

Links da web em mensagens de WhatsApp de formato livre

Mensagens de formato livre do WhatsApp que incluem links da web exibirão uma visualização de um trecho da página web quando recebidas no WhatsApp do cliente.

        
        
        
        Envie uma mensagem de formato livre dentro da sessão de 24 horas

        Envie uma mensagem de WhatsApp de saída em formato livre

        Envie uma mensagem de formato livre dentro da sessão de 24 horas
              
              
              
              Envie uma mensagem de mídia de formato livre dentro da sessão de 24 horas

              Envie uma mensagem do WhatsApp em formato livre com mídia

              Envie uma mensagem de mídia de formato livre dentro da sessão de 24 horas

              Monitore o status de sua mensagem de saída WhatsApp

              Para receber atualizações de status em tempo real para mensagens de saída, você pode escolher definir um URL de retorno de chamada de status. A Twilio envia uma solicitação a este URL toda vez que o status da mensagem muda para um dos seguintes: queued, failed, sent, delivered, read.

              Você pode definir o URL de retorno de chamada de status no console ou quando enviar uma mensagem de saída individual, incluindo o parâmetro StatusCallback. Você pode definir isso em diferentes partes do Twilio Console, dependendo da configuração das mensagens:

              Quando você define o URL de retorno de chamada de status, a Twilio envia uma solicitação POST para esse URL, incluindo o MessageSid (o identificador exclusivo da mensagem) junto com os outros parâmetros de solicitação padrão, bem como o MessageStatus e o ErrorCode.

              Os parâmetros que a Twilio envia para o URL de retorno de chamada incluem todos os parâmetros de solicitação padrão, bem como alguns parâmetros exclusivos de mensagens. Você pode ver a lista completa de parâmetros na Referência à API para o recurso de mensagem.

                    
                    
                    
                    Rate this page:

                    Precisa de ajuda?

                    Todos nós às vezes criamos; programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelos Fóruns da Comunidade da Twilio ou na tag Twilio no Stack Overflow.

                          
                          
                          

                          Obrigado pelo seu feedback!

                          Não medimos esforços para melhorar nossa qualidade de documentação, e seu feedback é valioso para nós. Selecione o(s) motivo(s) para seu feedback ou forneça informações adicionais sobre como podemos melhorar:

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

                          Obrigado pelo seu feedback!

                          Indique-nos e obtenha $10 em 3 etapas simples!

                          Etapa 1

                          Obtenha o link

                          Obtenha um link de indicação pessoal gratuito aqui

                          Etapa 2

                          Dê $10

                          Seu usuário se inscreve e faz a atualização usando o link

                          Etapa 3

                          Ganhe $10

                          1.250 mensagens SMS grátis
                          OU 1.000 min de voz grátis
                          OU 12.000 chats
                          OU mais