WhatsApp¶
O WhatsApp é um aplicativo de mensagens instantâneas e voz sobre IP que permite aos usuários enviar mensagens, fazer chamadas e compartilhar conteúdo. As empresas podem usar o WhatsApp Business para se comunicar com seus clientes por texto, enviar documentos e fornecer suporte.
Aviso
O WhatsApp é um aplicativo exclusivo do Odoo Enterprise que não funciona na edição Odoo Community. Para se inscrever na edição Odoo Enterprise, clique aqui: Odoo – Teste grátis.
Ver também
Para obter mais informações sobre a migração da versão Odoo Community para a versão Odoo Enterprise, consulte esta documentação: Trocar de Community para Enterprise.
Com o aplicativo WhatsApp do Odoo, uma empresa pode conectar uma conta do WhatsApp Business (WABA) a uma base de dados Odoo, o que permite o seguinte:
Receber e responder a mensagens do WhatsApp diretamente de uma base de dados do Odoo
Criar novos modelos com marcadores de posição/variáveis dinâmicos
Envie modelos pré-aprovados que usem variáveis dinâmicas, como:
Quotations from the Sales app
Receipts and invoices from the Point of Sale app
Tickets from the Events app
Ver também
O WhatsApp é um serviço de mensagens operado pela Meta, que é a empresa controladora do Facebook. O WhatsApp é comumente usado como ferramenta de comunicação em muitos países e por muitas empresas. Esta documentação abordará a integração de uma conta comercial do WhatsApp com o Odoo. A conta Meta da empresa é configurada no Odoo por meio de uma conexão de API.
The WhatsApp connector supports two flows: company initiated, and customer initiated. A company can initiate a discussion by sending a template to one or more people. Once the template is sent, the recipient can answer in order to trigger a discussion between the sender and the receiver (a Discuss chat window appears if the customer answers within 15 days).
Se a comunicação for iniciada pelo cliente (por exemplo, enviando mensagens para o número público do WhatsApp da empresa), o Odoo abrirá um chat em grupo com todos os operadores responsáveis por esse canal do WhatsApp.
Dica
É recomendável configurar várias contas do WhatsApp para diferentes departamentos. Por exemplo, a equipe da central de ajuda e as equipes de vendas podem conversar em canais diferentes.
WhatsApp configuration in Meta¶
Uma integração do WhatsApp com o Odoo usa uma conexão padrão API e é configurada na Meta nas seguintes etapas:
Criar uma conta Meta Business
Criar uma conta de desenvolvedor da Meta
Configure um app e um produto do WhatsApp no console do desenvolvedor da Meta
Teste a conexão da API.
Uma vez conectado, as mensagens são enviadas e recebidas pelo aplicativo Mensagens do Odoo, usando a API do WhatsApp.
Configuração da conta Meta Business¶
Para criar uma conta comercial com a Meta (proprietária do Facebook), navegue até: Facebook Business Manager. Comece clicando em Criar conta e, em seguida, insira o nome da empresa, o nome do administrador e um endereço de e-mail comercial. Em seguida, clique em Próximo e uma janela pop-up será exibida solicitando a confirmação do endereço de e-mail. Após a confirmação, clique em Concluído para fechar a janela.
Em seguida, siga as instruções no e-mail enviado pelo Facebook para confirmar a criação da conta comercial e concluir o processo de configuração.
Ver também
Importante
Se a conta comercial estiver vinculada a uma conta pessoal do Facebook, o administrador deverá alternar entre a conta pessoal e a conta comercial durante o restante da configuração.
To toggle to the business account navigate to the Facebook Developer Console and click on the account name in the upper right corner. Under the Business Accounts heading, click on the desired business that the WhatsApp configuration should take place in. This is the account for which Odoo will send and receive WhatsApp messages.
Importante
Para criar uma conta comercial do Meta, o usuário já deve ter uma conta pessoal do Facebook que exista há pelo menos uma hora antes de configurar a conta comercial do Facebook. A tentativa de criar a conta comercial antes desse período resultará em erro.
Criação de aplicativos¶
No painel do Meta for Developers, faça login com a conta de desenvolvedor da Meta. Se ainda não houver uma conta configurada, vincule uma conta do Facebook para criar uma conta de desenvolvedor da Meta.
Nota
Uma conta de desenvolvedor do Facebook é diferente de uma conta empresarial do Facebook. As contas de desenvolvedor são compostas por contas pessoais do Facebook, mas as contas empresariais não são, pois representam uma empresa e gerenciam todos os ativos da empresa no Meta, como aplicativos.
Ver também
Click on My Apps in the top-right corner after successfully signing in to the Meta developer account. This will redirect the administrator to all the apps the developer has configured in this specific developer account. Click on Create App to begin the process of configuring a new Meta application.
Tipo de aplicativo¶
Na página , selecione Outros na seção intitulada Procurando outra coisa? e, em seguida, clique em Próximo para ser direcionado a outra página a fim de selecionar o tipo de aplicativo. Em seguida, clique na primeira opção listada sob o rótulo Selecionar um tipo de aplicativo, intitulada Business. Essa seleção permite a criação e o gerenciamento da API (Interface de Programação de Aplicativos) do WhatsApp.
Agora, clique em Próximo para configurar o aplicativo, conforme desejado. Quando o tipo de aplicativo tiver sido configurado, o administrador passará para a seção detalhes do aplicativo.
Detalhes do aplicativo¶
Na seção Detalhes do processo Criar um aplicativo, digite Odoo no campo abaixo do rótulo Adicionar um nome ao app.
Nota
O nome do aplicativo pode ser alterado posteriormente nas configurações, se necessário.
Aviso
As marcas registradas e os elementos de marca não podem ser usados nesta seção de texto. Isso inclui o grupo de empresas Meta. Não inclua a palavra: WhatsApp ou o sistema sinalizará isso como um erro.
Em seguida, insira o endereço de e-mail do desenvolvedor no campo abaixo do rótulo E-mail de contato do app.
Por fim, defina o campo Conta Business - Opcional para o perfil da conta Meta Business, usando o menu suspenso. Para concluir, clique em Criar app. Essa ação criará o aplicativo e solicitará os contratos Termos da plataforma da Meta e Políticas do Desenvolvedor.
Para aceitar os acordos, digite a senha do Facebook para fins de segurança e clique em Enviar para finalizar a criação do aplicativo. O navegador será direcionado para o painel do Meta for Developers.
Nota
If the Meta business account is prohibited from advertising, claiming an app is not allowed. To resolve this issue navigate to https://business.facebook.com/business for assistance.
Para obter mais informações, consulte a documentação da Meta sobre restrições de publicidade.
Adicionar um produto do WhatsApp ao aplicativo¶
Agora que a estrutura básica do aplicativo foi criada, será necessário adicionar um produto ao aplicativo. Comece acessando o painel do aplicativo Meta navegando até https://developers.facebook.com/apps e clicando no aplicativo que está sendo configurado.
On the next page: since WhatsApp is used, click Set up next to the box containing WhatsApp, located towards the bottom of the page.
A página direciona para a página de configuração da API do WhatsApp Business Platform. Use o menu suspenso para selecionar o Meta Business a ser configurado para a opção Selecionar uma conta do Meta Business e, em seguida, clique em Continuar para confirmar a seleção.
Nota
Quando Continuar é clicado, o administrador concorda com os termos e condições da Meta, conforme vinculados no Painel de aplicativos da Meta.
Nota
Depois que o produto WhatsApp for adicionado ao aplicativo, A Meta fornecerá um número de telefone de teste do WhatsApp com 5 mensagens de teste.
Começar a usar a API do WhatsApp¶
Depois de concluir o assistente de produto do WhatsApp anterior e clicar em Continuar, o navegador será direcionado para a página Quickstart do WhatsApp; é nessa página Quickstart que você deve começar a configurar a API do WhatsApp adicionando um número de telefone e enviando uma mensagem de teste inicial.
Nota
If the browser is not on the Quickstart page for WhatsApp, navigate to
https://developers.facebook.com/apps and click on the app that is being configured, (the app
name is Odoo if the instructions above were followed).
Em seguida, no menu do lado esquerdo da página, clique no ícone v (alternador de menu) ao lado do título da seção WhatsApp. Um pequeno menu será aberto, contendo as seguintes opções:
Quickstart
Configuração da API
Configuração
Clique na opção Quickstart e, em seguida, clique em Começar a usar a API.
Configuração da API¶
Depois de clicar em Começar a utilizar a API, a página navega para Configuração da API. Agora que o número de teste foi criado, uma mensagem de teste pode ser enviada para confirmar que o WhatsApp está funcionando corretamente. Para começar, navegue até a seção da página denominada Enviar e receber mensagens e clique no menu suspenso ao lado de Para, em Etapa 1 Selecionar números de telefone.
Agora, selecione a única opção disponível: Gerenciar lista de números de telefone. Siga as etapas e adicione até cinco números para enviar as mensagens de teste gratuitas. Depois de inserir o código do país e o número de telefone adeequados, clique em Próximo.
Importante
Adicionar um número de telefone para envios nesta etapa permitirá que um teste bem-sucedido seja enviado pelo terminal. Isso é fundamental para garantir que a API do WhatsApp esteja funcionando.
Um código de verificação do WhatsApp Business é então enviado para o número de telefone, que precisa ser inserido na próxima tela para verificar a propriedade do número. Digite o código de verificação e clique em Próximo para verificar o número.
Enviar uma mensagem de teste pelo terminal¶
Em seguida, envie uma mensagem de teste pelo terminal. Na seção denominada Etapa 2 Enviar mensagens com a API, clique em Enviar mensagem. Uma mensagem de teste será enviada para o número de telefone que foi definido na seção anterior.
Após receber com êxito a mensagem no número, passe para a próxima seção para produzir e configurar webhooks.
Configuração do WhatsApp no Odoo¶
As próximas etapas configuradas nesta seção são todas na base de dados do Odoo, onde é necessário configurar alguns valores diferentes para token, número de telefone e IDs de conta; esses valores são necessários para criar um URL de retorno de chamada e um Token de verificação do Webhook, que são usados para configurar os webhooks (para receber mensagens de volta na base de dados).
No Odoo, navegue até o . Em seguida, clique em Novo para configurar a conta comercial do WhatsApp no Odoo.
Em outra aba do navegador, navegue até e, em seguida, copie os seguintes valores do console do desenvolvedor do Meta para os campos correspondentes no Odoo:
Nome |
Console da Meta |
Interface do Odoo |
|---|---|---|
Telefone |
ID do número de telefone |
ID do número de telefone |
Token |
Token de acesso temporário |
Token de acesso |
ID do aplicativo |
ID do aplicativo |
ID do aplicativo |
ID da conta |
ID da conta do WhatsApp Business |
ID da conta |
Para recuperar o Segredo do app, navegue até o console do desenvolvedor da Meta, https://developers.facebook.com/apps e selecione o aplicativo no qual o Odoo está sendo configurado. Em seguida, no menu do lado esquerdo, em Configurações do app, selecione Básico.
Em seguida, clique em Mostrar ao lado do campo Segredo do app e digite a senha da conta para verificar a propriedade. Copie o Segredo do app e cole o valor copiado no campo Segredo do app no painel de configuração do Odoo Conta do WhatsApp Business.
Para concluir a configuração da conta WhatsApp Business no Odoo, clique em Testar conexão. Se a configuração estiver definida corretamente, uma mensagem de sucesso em verde aparecerá no canto superior direito do painel..
Configuração de webhooks¶
Para configurar os webhooks para o WhatsApp no Odoo, navegue até https://developers.facebook.com/apps e selecione o aplicativo no qual o Odoo está sendo configurado. Em seguida, no cabeçalho do menu WhatsApp no lado esquerdo da tela, clique no item de menu Configuração de API. Finalmente, vá para a seção marcada como Etapa 3: Configurar webhooks para receber mensagens e clique em Configurar webhooks.
Dica
Outra maneira de configurar Webhooks é navegar até https://developers.facebook.com/apps e selecionar o aplicativo no qual o Odoo está sendo configurado. Em seguida, selecione Webhooks no menu à esquerda.
On the page, click on Edit, where both the Callback URL and Webhook Verify Token values from Odoo are added.
Nota
Os valores de URL de callback e Token de verificação do webhook foram preenchidos automaticamente após clicar em Testar conexão na etapa anterior.
Em uma janela diferente do navegador, colete os valores necessários no Odoo navegando até e selecione a conta que está sendo configurada. Localize os valores na seção denominada Receber mensagens.
Copie e cole o URL de callback do Odoo no campo URL de callback da Meta. Da mesma forma, copie e cole o Token de verificação do webhook também no campo Token de verificação no console do desenvolvedor da Meta.
Por fim, clique em Verificar e salvar para registrar os valores no console do desenvolvedor da Meta.
Campos do webhook¶
Now input individual webhook fields into Meta’s developer console, under the Webhook fields section. Click Manage and when the pop-up window appears, check the boxes in the Subscribe column for the following field names:
account_updatemessage_template_quality_updatemessage_template_status_updatemessagestemplate_category_update
Depois de fazer as seleções, clique em Concluído.
A configuração finalizada do Webhooks aparecerá assim no console do desenvolvedor do Meta:
Importante
Os campos do Webhook só serão exibidos depois que a assinatura for confirmada usando o URL de callback e o Token de verificação do webhook.
Ver também
Documentação do WhatsApp da Meta sobre a configuração de webhooks <https://developers.facebook.com/docs/whatsapp/cloud-api/guides/set-up-webhooks>`_.
Adicionar número de telefone¶
Para configurar o número de telefone a ser usado pelo WhatsApp no Odoo, volte para o console do desenvolvedor da Meta (https://developers.facebook.com/apps) e selecione novamente o aplicativo no qual o Odoo está sendo configurado. Sob o título do menu WhatsApp no lado esquerdo da tela, clique no item de menu Configurar API. A partir daí, vá para a seção marcada como: Etapa 5: Adicionar número de telefone e clique em Adicionar número de telefone.
Nos campos, insira um Nome da empresa e um Site da empresa ou página de perfil.
Dica
O campo Site da empresa ou página de perfil pode ser o URL de uma página de redes sociais.
Conclua o preenchimento das informações comerciais selecionando no menu suspenso da seção País o país em que a empresa faz negócios. Se quiser, adicione um endereço, mas essa informação é opcional. Depois de adicionar o local, clique em Próximo para continuar.
A página a seguir contém informações para o perfil do WhatsApp Business. Preencha as seções a seguir de acordo:
Nome de exibição do perfil do WhatsApp Business
Fuso horário
Categoria
Descrição do negócio (opcional)
Quando essas seções estiverem preenchidas, clique em Próximo. A página é atualizada e solicita que o administrador Adicione um número de telefone para o WhatsApp no respectivo campo. Aqui, insira o número de telefone a ser configurado no WhatsApp.
Em seguida, escolha um método de verificação para o número de telefone. Selecione Mensagem de texto ou Ligação e clique em Próximo para prosseguir.
O número de telefone inserido receberá um texto ou uma chamada telefônica do WhatsApp com um código, dependendo do método de verificação escolhido. Digite esse código de verificação no campo Código de verificação e clique em Próximo para concluir.
Aviso
If a payment method has not been added, this is necessary to proceed. Visit Meta’s documentation on how to add a payment method in Meta’s Business Manager. This is part of Meta’s fraud detection system, in order to ensure that the account/company are real a payment method is required to proceed.
Token permanente¶
Após a conclusão da configuração e dos testes, um token permanente deve ser criado para substituir o Token temporário.
Comece navegando até https://business.facebook.com/ e, em seguida, vá para . Selecione um usuário do sistema existente ou crie um novo usuário do sistema clicando em Adicionar.
Os ativos agora devem ser adicionados ao usuário do sistema e, em seguida, um token permanente pode ser gerado.
Aviso
This is a mandatory step. If the permanent token is not added, the Odoo database shows a token error.
Clique em Adicionar recursos e, quando a janela pop-up aparecer, selecione Aplicativos em Selecionar tipo de recurso. Em seguida, selecione o aplicativo Odoo e alterne as permissões para Ativo na opção Controle total. Defina essa nova configuração de permissão clicando em Salvar alterações, e aparecerá uma janela de confirmação da adição do ativo ao usuário do sistema. Conclua clicando em Concluído.
Next, the permanent token gets generated. Click on Generate new token, and a pop-up window will appear asking which app this token should be generated for. Select the App that this token is for. Then determine the expiration date of either 60 days or Never.
Por fim, quando o Meta perguntar quais permissões o usuário do sistema deve conceder, adicione todas as seguintes permissões:
business_managementwhatsapp_business_messagingwhatsapp_business_managementwhatsapp_business_manage_events
Quando as permissões estiverem definidas, clique em Gerar token. Copie o valor do token que aparece na tela a seguir.
Com esse valor de token, atualize o campo Token de acesso na conta do WhatsApp Business no Odoo, navegando até o .
Entrar em operação com o aplicativo Meta¶
Por fim, para iniciá-lo, o aplicativo Meta deve ser definido como Live no console do desenvolvedor do Meta. Navegue até https://developers.facebook.com/apps e clique no aplicativo que está sendo configurado. No menu superior, alterne o campo App Mode de Development para Live.
Importante
Se o status do aplicativo não estiver definido como live, a base de dados só poderá entrar em contato com os números de teste especificados no console do desenvolvedor.
Aviso
Um URL de política de privacidade deve ser definido para que o aplicativo seja ativado. Acesse o console do desenvolvedor do Meta, https://developers.facebook.com/apps e selecione o aplicativo no qual o Odoo está sendo configurado. Em seguida, usando o menu no lado esquerdo da tela, acesse as . Em seguida, insira o endereço do hiperlink da política de privacidade no campo URL da Política de Privacidade do formulário. Clique em Salvar alterações para aplicar a política de privacidade ao aplicativo.
Depois que o aplicativo for ativado no console do desenvolvedor da Meta, um e-mail de confirmação será enviado ao administrador.
Modelos do WhatsApp¶
Os modelos do WhatsApp são mensagens salvas que são usadas repetidamente para enviar mensagens pela base de dados. Eles permitem que os usuários enviem comunicações de qualidade, sem precisar compor o mesmo texto mais d euma vez.
A criação de modelos diferentes, adaptados a situações específicas, permite que os usuários escolham a mensagem certa para o público certo. Isso aumenta a qualidade da mensagem e a taxa geral de engajamento do cliente.
Os modelos do WhatsApp podem ser criados nos consoles do Odoo e da Meta. O processo a seguir apresentará uma visão geral do processo de criação de modelos no Odoo e, posteriormente, na Meta.
Importante
O WhatsApp tem um processo de aprovação que deve ser concluído antes que o modelo possa ser usado. Aprovação de modelo da Meta.
Criar modelos no Odoo¶
Para acessar e criar modelos do WhatsApp, comece navegando até o painel .
Na parte inferior do formulário de um modelo individual, há três abas: Corpo, Botões e Variáveis; essas três abas combinadas criam o modelo do WhatsApp.
O texto é inserido na aba Conteúdo e o conteúdo dinâmico que é chamado na aba Conteúdo é especificado na aba Variáveis. Cada parte do conteúdo dinâmico (por exemplo, marcadores de posição) na mensagem (corpo) é especificamente chamada e especificada na aba Variáveis.
Modelos são layouts pré-fabricados que permitem aos usuários enviar mensagens com aspecto profissional aos clientes. Esses modelos são capazes de conter dados dinâmicos, que serão preenchidos na mensagem final usando variáveis definidas na configuração do modelo. Por exemplo, as mensagens podem conter o nome do usuário final, chamar a atenção para produtos específicos ou fazer referência a um pedido de venda, para citar algumas variáveis convenientes e impactantes.
Para criar um modelo do WhatsApp, vá para o painel do e clique em New. No formulário, insira um Nome para o modelo e selecione um Idioma.
Importante
Para concluir a próxima tarefa, são necessários direitos de acesso de administrador para editar o campo É aplicável a. Consulte esta documentação sobre direitos de acesso para obter mais informações.
No menu suspenso Conta, selecione a conta do WhatsApp Business no Odoo à qual esse modelo deve se vincular. Em seguida, no campo :guilabel:`É aplicável a `, selecione o modelo ao qual a ação do servidor se aplicará para esse modelo.
Dica
These models can also be accessed in developer mode. On a contact form (or similar relevant form in Odoo), navigate to the model that is referenced, and hover over any field name. The backend information box displays the Odoo Model name. Search (using the front-end name) for this model in the Applies to drop-down menu in the WhatsApp template.
Aviso
Muitas vezes, ao alterar o modelo ou o campo É aplicável a, o campo Telefone pode gerar um erro. O campo Telefone deve sempre ser definido para o modelo Telefone ou Celular.
To search available fields, type in the front-end name in the search box. This finds a result from all of the available fields for the model (Applies to) that the template is created for.
Nota
Para localizar campos específicos, pode ser necessário navegar por vários níveis na caixa de resultados da pesquisa. Use os ícones > (divisa à direita) e ⬅️ (seta à esquerda) para navegar entre os níveis do menu.
Change the Category to fit either a Marketing, Utility, or Authentication category. In most instances the first two options are used, unless the user would like to send a password reset or something security related. Set to Marketing should there be anything promotional being sent and set to Utility should there be general transactional messages being sent (i.e., sales order, event ticket, etc).
Importante
A especificação de uma categoria incorreta pode causar um status de sinalização/rejeição da Meta durante o processo de aprovação.
Adicione Usuários que tenham permissão para usar esse modelo. Na coluna do lado direito, um Tipo de cabeçalho também pode ser configurado junto com um mensagem de cabeçalho.
Os Tipos de cabeçalho disponíveis são os seguintes:
Texto
Imagem
Vídeo
Documento
Localização (as variáveis precisam ser definidas)
Navegue até a aba Conteúdo para configurar a mensagem principal do modelo.
Quando todas as alterações necessárias forem feitas no modelo, clique no botão Enviar para aprovação no canto superior esquerdo. Isso fará com que o status do modelo seja alterado para Pendente.
O status permanecerá como Pendente até que uma decisão tenha sido tomada pela Meta, quando um e-mail de confirmação será enviado indicando que o modelo foi aprovado (ou rejeitado). Os modelos precisarão então ser sincronizados pela base de dados do Odoo.
Consulte esta seção para obter mais informações sobre sincronizar modelos.
Dica
Consider the preconfigured demo data templates available in Odoo to use or modify. These templates can be used as-is or modified to suit a specific business need.
To use these templates, navigate to and select a preconfigured template. Click Submit for Approval to start the approval process. An email gets sent to the administrator of the Meta account when the template has been approved.
Usar marcadores de posição e variáveis¶
As variáveis dinâmicas fazem referência a determinados campos na base de dados do Odoo para produzir dados exclusivos na mensagem do WhatsApp ao usar um modelo. As variáveis dinâmicas são codificadas para exibir campos de dentro da base de dados, referenciando campos de dentro de um modelo.
Example
Muitas empresas gostam de aprimorar suas mensagens do WhatsApp com informações personalizadas do cliente para chamar a atenção. Isso pode ser feito no Odoo pela referenciação de um campo em um modelo, definindo uma variável dinâmica. Por exemplo, o nome de um cliente pode ser referenciado no e-mail a partir do campo Cliente no modelo Pedido de venda.
As variáveis dinâmicas podem ser adicionadas ao Conteúdo adicionando marcadores de posição no texto. Para adicionar um marcador de posição no corpo da mensagem, digite o seguinte texto {{1}}. Para o segundo marcador de posição, digite {{2}} e aumente gradualmente à medida que mais forem adicionados ao texto.
Example
O texto a seguir é o corpo do modelo de recibo de pagamento:
Prezado(a) {{1}},
Agradecemos
Ver também
Esses marcadores de posição devem ser configurados na aba Variáveis do modelo antes de serem enviados para aprovação da Meta. Para editar as variáveis dinâmicas em um modelo, primeiro altere o Tipo para Campo do modelo. Isso permite que o Odoo faça referência a um campo dentro de um modelo para produzir dados exclusivos na mensagem que está sendo enviada.
Em seguida, edite o Campo das variáveis dinâmicas. O campo É aplicável a no modelo deve ser editado antes para garantir que o modelo e o campo corretos sejam referenciados.
Para pesquisar os campos disponíveis, digite o nome de front-end do campo na caixa de pesquisa. Isso encontrará como resultado todos os campos disponíveis no modelo (Se aplica a) para o qual o modelo foi criado. Pode haver vários níveis que precisam ser configurados.
Example
A seguir, há um exemplo das variáveis definidas nos marcadores de posição acima no recibo de pagamento mencionado acima:
Nome |
Amostra de valor |
Tipo |
Campo |
|---|---|---|---|
corpo - {{1}} |
Azure Interior |
Campo do modelo |
|
corpo - {{2}} |
INV/2022/00001 |
Campo do modelo |
|
corpo - {{3}} |
Minha empresa |
Campo do modelo |
|
corpo - {{4}} |
$ |
Campo do modelo |
|
corpo - {{5}} |
4000 |
Campo do modelo |
|
corpo - {{6}} |
https://.. |
Link do portal |
Example
Por exemplo, na aba Conteúdo, se for digitado o seguinte: “Olá, {{1}},”, então {{1}} deverá ser definido na guia Variáveis. Nesse caso específico, a mensagem deve cumprimentar o cliente pelo nome, portanto, o {{1}} deve ser configurado para preencher o {{1}} Campo com o nome do Cliente.
Aviso
A personalização dos modelos do WhatsApp está fora do escopo do Suporte do Odoo.
Aprovação de modelo da Meta¶
Depois de atualizar as variáveis dinâmicas no modelo, ele precisa ser novamente enviado à Meta para aprovação. Clique em Enviar para aprovação para iniciar o processo de aprovação. Um e-mail será enviado ao administrador da conta da Meta quando o modelo for aprovado.
Após a aprovação da Meta, sincronize os modelos novamente na base de dados do Odoo. Consulte esta documentação: Sincronizar modelos.
Dica
Para ver o status no painel de modelos do WhatsApp da Meta, navegue até https://business.facebook.com/wa/manage/home. Em seguida, vá para .
Sincronizar modelos¶
Os modelos devem ser sincronizados na base de dados do Odoo depois de serem aprovados pela equipe da Meta. Para isso, comece acessando o e selecione a configuração que deve ser sincronizada. Na seção marcada como , na parte inferior, clique em Sincronizar modelos. A Meta atualizará os modelos aprovados para que possam ser utilizados com vários aplicativos na base de dados.
Uma mensagem de sucesso em verde é exibida no canto superior direito com o número de modelos atualizados.
Dica
Os modelos também podem ser sincronizados individualmente a partir do próprio modelo. Navegue até o painel do e selecione o modelo a ser sincronizado. Em seguida, clique no botão Sincronizar modelo localizado no menu superior do formulário do modelo.
Criação de modelos na Meta¶
Primeiro, navegue até o painel de modelos do WhatsApp do Meta e, em seguida, vá para .
To create a WhatsApp template, click on the blue Create template button, and then select the Category. The options listed include: Marketing, Utility, and Authentication. In most instances the first two options are used, unless the user would like to send a password reset or something security related.
Digite o Nome do modelo e, em seguida, selecione um Idioma para o modelo.
Nota
Multiple languages can be selected.
Depois de fazer as seleções apropriadas, clique em Continuar no canto superior direito. A página é redirecionada para a página Editar modelo. Aqui, o Cabeçalho, o Conteúdo, o Rodapé e os Botões são configurados. À direita do modelo, há uma visualização de como o modelo será exibido em produção.
When all the necessary changes are made to the template, click on the Submit button in the upper-right corner. A confirmation window appears to confirm the language— click Confirm to approve and then another window appears stating that the template gets submitted to Meta for review and approval.
O Status do modelo permanecerá em Em revisão até que uma decisão tenha sido tomada pela Meta. Depois que um e-mail de confirmação for recebido aprovando o modelo, os modelos precisarão ser sincronizados a partir do base de dados do Odoo.
Ver também
Para obter mais informações sobre a configuração de modelos no console do desenvolvedor do Meta, visite a documentação de modelos do WhatsApp da Meta <https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/>`_.
Notificações¶
As notificações no WhatsApp são tratadas de forma semelhante a uma conversa por mensagem no Odoo. Uma janela pop-up é exibida com a conversa do cliente. Por padrão, as notificações são definidas na configuração da conta do WhatsApp Business no Odoo.
Notification settings can be adjusted by navigating to . From there, select the account and scroll down to the section where notifications are handled. Under the Notify users heading, type in the field which users should be notified for this particular WhatsApp channel.
Nota
Once a conversation is initiated between a user and a customer, notifications to all the users specified in the WhatsApp business account configuration will not occur. Only notifications to the users in the conversation will occur. Should the user not respond within 15 days, the customer’s reply after the 15 days will populate once again to all the users specified in the WhatsApp configuration.
Adicionar usuários ao chat¶
É possível adicionar usuários a um chat do WhatsApp expandindo a janela pop-up do WhatsApp. As conversas do WhatsApp estão localizadas no aplicativo Mensagens. Clique no ícone 👤+ (adicionar usuário) ao lado da conversa, e uma janela será exibida para convidar usuários.
FAQ da API do WhatsApp¶
Verificação¶
A partir de 1º de fevereiro de 2023, se o aplicativo Meta exigir acesso de nível avançado às permissões, talvez seja necessário concluir uma verificação comercial completa. Isso inclui o envio de documentos comerciais para a Meta. Consulte esta documentação.
Erros de modelo¶
A edição de modelos pode causar tracebacks e erros, a menos que seja seguido o exato processo descrito acima aqui: (Modelos do WhatsApp).
Erro de validação de duplicata¶
Ao sincronizar os modelos, pode haver casos em que existam vários modelos com o mesmo nome no gerenciador empresaarial da Meta e no Odoo. Isso causa erros de validação por duplicatas. Para corrigir esse problema, renomeie o nome do modelo duplicado no Odoo e sincronize novamente os modelos, seguindo as etapas aqui: Sincronizar modelos.
Erros de token¶
Erro do usuário¶
Se o token temporário não for substituído por um token permanente, um erro de usuário será populado no Odoo ao testar a conexão após a falha no envio. Para corrigir esse problema, consulte Token permanente.
Erro 100 de usuário do sistema¶
Se o usuário do sistema for um Funcionário ao configurar o token permanente, será exibido um erro 100 de usuário.
Para corrigir esse erro, crie um usuário Admin seguindo o processo descrito aqui: Token permanente.
