Principais conceitos e termos para a WhatsApp Business API da Twilio

Ao usar a WhatsApp Business API da Twilio, você se conecta aos usuários no aplicativo de mensagens mais popular do mundo, tudo com o poder das APIs da Twilio.

O WhatsApp é um canal altamente regulamentado, e começar a usá‐lo requer documentação e aprovação do Facebook. Este documento abrange os principais conceitos e termos comuns que você encontrará ao usar a WhatsApp Business API da Twilio.

O "intervalo de 24 horas" ou a "sessão de 24 horas"

O WhatsApp regula quando e como você pode enviar mensagens para seus usuários finais. Quando um usuário final envia uma mensagem do WhatsApp para sua empresa, ele inicia uma "sessão" ou um "período" de 24 horas do WhatsApp, durante o qual você pode enviar mensagens de formato livre (não modeladas) para o usuário. Uma sessão do WhatsApp dura 24 horas após a última mensagem recebida de um usuário.

Fora de uma sessão do WhatsApp, você só pode enviar uma mensagem seguindo um modelo pré‐aprovado para o usuário. Qualquer mensagem que não corresponda a um modelo pré‐aprovado é considerada uma mensagem de formato livre. Para obter mais informações, leia abaixo e consulte nosso guia sobre como usar mensagens modeladas para notificações do WhatsApp.

Modelos de notificação do WhatsApp

Fora da sessão de 24 horas do WhatsApp, sua empresa só pode enviar mensagens para seus usuários finais seguindo modelos pré‐aprovados. Alguns exemplos dessas mensagens modeladas são:

• "Seu código de login para {{1}} é {{2}}."
• "A entrega da sua {{1}} está a caminho. Ela deve chegar em {{2}}."

Nos exemplos acima, {{1}} e {{2}} e são as informações específicas da mensagem para um determinado usuário final.

Ao começar a usar a WhatsApp Business API da Twilio, você pode enviar modelos para aprovação pelo WhatsApp. Consulte nosso guia para o processo de aprovação e como enviar mensagens com os modelos de notificação do WhatsApp.

Além disso, o Twilio Sandbox para WhatsApp tem três modelos pré‐aprovados que você pode usar para testar essa funcionalidade antes que seu número da Twilio seja aprovado para enviar mensagens do WhatsApp.

WhatsApp Business Account (conta de negócios) (WABA)

Uma WhatsApp Business Account (conta de negócios) (WABA) é uma conta para sua empresa enviar e receber mensagens por meio da WhatsApp Business API. Quando você quiser se conectar com seus usuários finais pelo WhatsApp usando a Twilio, criaremos e gerenciaremos uma WABA em seu nome. Este processo está documentado no guia Conecte seu número de telefone da Twilio ao seu guia Perfil do WhatsApp Business.

Cada conta, subconta ou projeto da Twilio só pode ser associado a uma WABA e essa WABA deve ser exclusiva. No entanto, o WhatsApp não impõe limites quanto ao número de WABAs que uma empresa pode ter. Isso significa que, se você tiver várias contas, subcontas ou projetos, precisará ter várias WABAs, uma para cada entidade (conta, subconta ou projeto).

Meta Business Manager (Gerenciador de Negócios) (Meta BM)

Para ter uma WhatsApp Business Account (conta de negócios) (WABA), sua empresa deve ter uma conta do Meta Business Manager (Gerenciador de Negócios) (Meta BM) (anteriormente chamada de Facebook Business Manager). O Meta Business Manager (Gerenciador de Negócios) é uma ferramenta por meio da qual você organiza e gerencia seus negócios dentro do ecossistema Meta. É um conceito separado da WhatsApp Business Account (conta de negócios) (WABA)

Consulte as instruções do Meta para criar uma conta do Business Manager (Gerenciador de Negócios).

O Meta usa seu Meta BM para verificar a identidade da sua empresa por meio de um processo chamado "Verificação de empresas."

A Twilio precisa do seu ID do Meta Business Manager (Gerenciador de Negócios) para configurar uma WABA em nome da sua empresa para enviar e receber mensagens do WhatsApp.

Conta da Twilio, Account SID (SID da conta), SID da subconta e SID do projeto

Para usar a WhatsApp Business API da Twilio, você precisará se inscrever em uma conta da Twilio, que tem um identificador exclusivo de 34 dígitos, chamado "Identificador de string" ou "SID." (Para obter mais informações sobre SIDs, leia nossa página de glossário O que é um identificador de string?)

Em sua conta da Twilio, você pode comprar e configurar seus remetentes do WhatsApp, criar um protótipo usando o Twilio Sandbox para WhatsApp e enviar

Modelos de mensagem do WhatsApp para aprovação.

Se você for um Fornecedor de software independente (ISV) ou um terceiro operando em nome de outra empresa, provavelmente usará um SID de subconta da Twilio. Se estiver configurando com o Twilio Flex, você usará um SID do projeto Flex.

Sandbox da Twilio para WhatsApp

O Twilio Sandbox para WhatsApp é uma ferramenta criada pela Twilio para que você crie protótipos e teste o envio e recebimento de mensagens do WhatsApp antes de ser totalmente configurado com um número de remetente WABA e Twilio WhatsApp. Você pode ler mais em nosso guia detalhado para começar a usar o Twilio Sandbox para WhatsApp ou nosso passo a passo do início rápido para WhatsApp.