> For the complete documentation index, see [llms.txt](https://docs.fortics.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/fortics-voz/configurando-o-whatsapp-calling-no-chat-center.md). # Configurando o WhatsApp Calling no Chat Center Esta etapa é responsável por habilitar a Central Telefônica para interagir com o módulo Voz e estruturar os modelos avançados de mensagens (HSM). Esses modelos permitirão que os agentes humanos iniciem chamadas ativas ou recebam ligações receptivas de forma integrada à tela de atendimento. Acesse o menu lateral esquerdo do **Chat Center** e clique na opção **"Integrações"** para expandir as opções, conforme exibido abaixo. Na lista de submódulos, selecione a opção "**Central telefônica**" para carregar a tela de preenchimento. Ao acessar o painel, a interface exibirá uma estrutura de requisição HTTP dividida em blocos de cabeçalho, parâmetros e corpo. O mapeamento exige o preenchimento da primeira linha de campos superiores, destacada na cor roxa na imagem. **Host**: Insira a URL exata do endpoint fornecido pelo ecossistema para o processamento das chamadas (neste cenário, preencha com o endereço do servidor do Voz). {% hint style="danger" %} **## Importante** Embora os campos da seção "Central telefônica" digam respeito originalmente à estrutura de *Click to Call* (Clique para Ligar), o recurso de WhatsApp Calling depende obrigatoriamente de que eles estejam devidamente configurados no sistema. Sem essa parametrização, o botão nativo de ligação dentro do painel de atendimento do Contact Center não funcionará de forma correta. Para a plataforma Voz da fortics use [https://ambiente.sz.chat/voice/api/v1/pbx/click2call\
](https://ambiente.sz.chat/voice/api/v1/pbx/click2call)Alterando “[ambiente.sz](http://ambiente.sz).chat” pela URL do seu ambiente {% endhint %} **Método**: Clique no menu suspenso (dropdown) e selecione obrigatoriamente a opção POST, definindo o método HTTP de envio e gravação de dados utilizado para acionar a API do telefone. **Tipo**: Selecione no menu de contexto o modelo de comportamento da chamada (para este fluxo, marque a opção **Discagem rápida**). **Permissão de chamada WhatsApp Calling**: É o parâmetro mestre de validação do canal de voz no chat. Clique no menu suspenso e altere o status padrão de "*Desabilitar*" para "**Habilitar**". Esta ação autoriza o sistema a exibir os recursos de telefonia diretamente na tela do Contact Center. Após garantir o preenchimento do Host, a seleção do método POST, o tipo de discagem e a ativação da permissão de chamada, role a página até o final e clique no botão azul **"Salvar"**, localizado no canto inferior direito, para validar as credenciais e aplicar a integração. ## Criando um modelo de mensagem A execução de contatos ativos e receptivos via WhatsApp Calling depende da criação de componentes estruturados via JSON. Essa configuração define o comportamento visual dos botões de ligação no aplicativo do cliente. Acesse a opção "**Configurações**" para expandir o menu e clique em "**Modelos de mensagem"**. No canto superior direito da tela de listagem, clique no ícone de mais. {% hint style="warning" icon="lightbulb-exclamation-on" %} **##Dica** Para entender detalhadamente o funcionamento dos templates, regras de aprovação da Meta e boas práticas de escrita, [consulte o **Tutorial de Modelos de Mensagens**](/perguntas-frequentes/perguntas-frequentes-1/chat-center/modelos-de-mensagens-para-o-whatsapp.md) disponível na nossa base de conhecimento. Nele, você encontrará exemplos adicionais para otimizar a comunicação com seus clientes. {% endhint %} Na barra lateral que se abre à direita, role as opções de templates para baixo até encontrar o bloco "**Modelo de mensagem avançado**" e clique no botão azul "**Selecione"**. Ao carregar o formulário do modelo avançado, a primeira ação é associar um canal de disparo. No primeiro bloco superior identificado como "**Canal**", clique no ícone do **lápis** localizado no canto direito da tabela. Na nova barra lateral que se abre, localize o número de WhatsApp homologado no Channel Connect, ative a chave na coluna **"Ativar"** e clique no botão azul "**Salvar**". O número passará a constar na lista de canais autorizados a disparar este template. No bloco central "**Modelo de mensagem**", configure os campos de identificação e regras de visibilidade: **Nome**: Insira um identificador único, curto, em letras minúsculas e sem espaços para o template (Ex: fortics\_calling\_receptivo ou fortics\_calling\_ativo). **Descrição**: Texto de uso estritamente interno para descrever o propósito do modelo (Ex: Mensagem para o uso do WhatsApp Calling). Esse campo não é enviado para a Meta. **Selecione o tipo de modelo**: Abra o menu suspenso e escolha uma das duas opções específicas de acordo com a estratégia do fluxo de voz: * **Chamada de voz:** Destinado a contatos receptivos, criando um botão que faz o cliente ligar para a empresa. * **Solicitação de permissão de chamada:** Destinado a contatos ativos, criando um menu para o cliente autorizar a empresa a ligar para ele. {% hint style="info" %} **## Importante:** Caso a estratégia de negócio da sua empresa exija que o mesmo número de WhatsApp funcione tanto para realizar chamadas ativas quanto para receber chamadas receptivas, você deverá obrigatoriamente criar dois modelos de mensagem avançados distintos no painel. Um modelo deverá ser configurado especificamente com o tipo "Chamada de voz" e o outro configurado estritamente como "Solicitação de permissão de chamada". Note que o JSON, que será mencionado abaixo, deve ser criado de acordo com a opção selecionada em **“Selecione o tipo de modelo”**. {% endhint %} **Visibilidade:** Define quem tem permissão de enxergar o modelo dentro do Chat Center (selecione a opção **"Todos"** para liberar o uso geral da conta). ## Criando o JSON Os campos **"JSON de criação"** e **“JSON de Envio”** funcionam como o editor de código e o núcleo lógico do seu modelo avançado. É através deles que você insere os parâmetros utilizados para renderizar a interface de voz diretamente no aplicativo do usuário final, determinando se o layout exibido na tela do celular será um botão de chamada imediata ou um menu de preferências de privacidade. Para evitar erros de sintaxe ou quebras de comunicação com a API, [o código colado neste bloco deve seguir rigidamente a documentação de esquemas do WhatsApp Business](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview). A estrutura de dados muda completamente dependendo do objetivo do seu fluxo de voz, dividindo-se entre cenários **Receptivos** (onde o cliente liga para a sua empresa) e **Ativos** (onde a sua empresa solicita permissão para ligar para o cliente). ### Modelo receptivo {% hint style="danger" %} **## Atenção** As instruções para Modelo Receptivo devem ser usadas apenas quando a opção “**Chamada de voz”** está selecionada no campo **Selecione o tipo de modelo** do formulário. {% endhint %} O modelo de mensagem receptivo é utilizado quando o objetivo é fazer com que o cliente final tome a iniciativa de ligar para a empresa. Ao receber essa mensagem no WhatsApp, um layout interativo com um botão de chamada será exibido no celular do usuário. #### JSON de criação No bloco inferior **"JSON de criação"**, você deve colar o código estruturado que define as propriedades do template junto à Meta. Vamos trabalhar com o exemplo de JSON: ```json { "messaging_product": "whatsapp", "type": "template", "recipient_type": "individual", "template": { "name": "fortics_calling_receptivo", "language": { "code": "pt_BR" }, "components": [ { "type": "button", "sub_type": "voice_call", "parameters": [ { "type": "ttl_minutes", "ttl_minutes": 10080 } ] } ] } } ``` **Entendendo a estrutura** **messaging\_product**: Define o produto de mensagens utilizado (configurado universalmente como "whatsapp"). **type:** Determina o tipo de mensagem como "template" (modelo de mensagem homologado). **recipient\_type**: Indica o tipo de destinatário da mensagem (definido como "individual"). **template.name:** Nome identificador do modelo de mensagem. Este valor deve estar de acordo com o termo preenchido no campo **Nome** do formulário superior. **template.language.code**: Código do idioma do template (utilize obrigatoriamente "pt\_BR" para o português do Brasil). **components:** Bloco que agrupa os elementos visuais e botões da mensagem. **sub\_type**: Configurado rigidamente como "voice\_call" para indicar à Meta que o botão acionará uma chamada de voz padrão pelo aplicativo. **ttl\_minutes:** Parâmetro essencial do modelo receptivo. Ele estipula o tempo de validade (em minutos) da permissão de chamada que o cliente concederá à empresa assim que ele interagir com o botão. O valor padrão do sistema é 10080 (equivalente a 7 dias). O limite mínimo aceito é de 1 minuto e o máximo é de 43.200 minutos (\~30 dias). #### JSON de envio No campo "**JSON de criação"**, você deve colar o código estruturado que define as propriedades do template junto à Meta. Vamos trabalhar com o exemplo de json: ```json { "name": "fortics_calling_receptivo", "category": "UTILITY", "language": "pt_BR", "components": [ { "type": "BODY", "text": "Olá, você pode fazer uma ligação agora ou clicar no link que direciona para o site da empresa!" }, { "type": "BUTTONS", "buttons": [ { "type": "voice_call", "text": "Ligar agora" }, { "type": "URL", "text": "Site da empresa", "url": "https://www.google.com" } ] } ] } ``` **Entendendo a estrutura** **Name:** Nome identificador do modelo de mensagem. Este valor deve estar de acordo com o termo preenchido no campo **Nome** do formulário superior. **category**: Categoria funcional do modelo perante as regras da Meta (para mensagens transacionais e de atendimento, utilize sempre "UTILITY"). **components.type: "BODY**": Bloco responsável pelo conteúdo textual da mensagem. No campo text, você deve digitar o texto principal que o cliente lerá antes de clicar no botão (Ex: "Boa tarde. Você pode me ligar para tirar sua dúvida..."). **buttons**: Este modelo traz dois botões nativos por padrão na interface para o usuário final: * **voice\_call**: O botão de ligação telefônica. O rótulo visível do botão pode ser personalizado alterando a string do campo text (Ex: "Ligar agora"). * **URL**: Um botão acessório contendo um link clicável de redirecionamento externo. Você deve definir o texto de exibição no campo text (Ex: "Site da empresa") e inserir o link de destino completo no campo url (Ex: "\[[https://www.suaempresa.com.br\]\\(https://www.suaempresa.com.br)](https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/fortics-voz/https:/www.suaempresa.com.br]\\\(https:/www.suaempresa.com.br\))"). O JSON vai criar uma mensagem parecida com a mensagem abaixo no WhatsApp do cliente: ## Modelo de envio ativo O modelo de mensagem ativo é utilizado quando a sua empresa deseja iniciar o contato e ligar para o cliente final. Por determinação das políticas de privacidade da Meta, a empresa não pode disparar uma chamada telefônica diretamente; é obrigatório enviar primeiro um template estruturado solicitando que o usuário autorize o recebimento da ligação. #### JSON de criação No bloco inferior "**JSON de criação**" (que atua como o editor de código unificado da interface), você deve colar o código de engenharia que molda essa árvore de decisão de privacidade. Abaixo temos o modelo JSON que vamos utilizar no campo ```json { "messaging_product": "whatsapp", "type": "interactive", "recipient_type": "individual", "template": { "name": "fortics_calling_ativo", "language": { "code": "pt_BR" } }, "interactive": { "type": "call_permission_request", "action": { "name": "call_permission_request" }, "body": { "text": "TEXTO_DO_TEMPLATE" } } } ``` **Entendendo a estrutura** "**type": "interactive**": Define que a estrutura da mensagem renderizará um bloco interativo com componentes de interface na tela do usuário. **template.name**: O identificador único do modelo (no exemplo, "fortics\_calling\_ativo"). Este valor deve ser rigorosamente igual ao nome que você digitou no campo de texto superior do formulário. **template.language.code**: Trava o idioma padrão do disparo (utilize sempre "pt\_BR" para português do Brasil). **interactive.type**: "call\_permission\_request": Informa ao ecossistema do WhatsApp que o componente interativo gerado é um bloco nativo de solicitação de privacidade para chamadas de voz. **action.name: "call\_permission\_request**": Declara a ação automática do sistema que aciona as regras de consentimento no dispositivo do cliente. **body.text**: Este é o campo textual principal que o cliente final lerá na notificação do celular. Você deve obrigatoriamente substituir o valor marcador "TEXTO\_DO\_TEMPLATE" pelo texto comercial da sua empresa (Ex: "Olá! Podemos iniciar sua chamada de voz agora?" ou "Sua solicitação de contato foi recebida. Autoriza nossa ligação?"). Para o modelo acima o cliente irá receber uma validação para autorizar o recebimento de ligação, como nas imagens abaixo: #### JSON de Envio Para esse modelo de mensagem vamos deixar esse campo em branco. ## Salvando o modelo Após validar a integridade das chaves e vírgulas dos códigos JSON, certifique-se de clicar no botão azul "**Salvar**" para encaminhar o template receptivo para o processo de aprovação da Meta.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/fortics-voz/configurando-o-whatsapp-calling-no-chat-center.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.