Como configurar um canal do WhatsApp?

Última atualização: [Data da Atualização]

Este guia detalha como configurar um canal do WhatsApp na sua conta Yuzap usando a API do WhatsApp Cloud hospedada pela Meta.

Provedor Suportado: API do WhatsApp Cloud via Meta.

Pré-requisitos

1. Conta Empresarial da Meta Verificada: Você precisa ter uma conta empresarial da Meta verificada. Se ainda não tiver uma, siga este guia da Meta para criar e verificar sua conta. A verificação é necessária para acesso completo à API.

2. Número de Telefone: Você precisará de um número de telefone que não esteja atualmente vinculado a nenhuma conta do WhatsApp (pessoal ou empresarial).

Passo 1: Crie um Aplicativo Meta

1. Acesse o portal Meta for Developers.

2. Clique em "Meus Aplicativos" e depois em "Criar aplicativo".

3. Selecione o tipo de aplicativo "Outro" e clique em "Avançar".

4. Selecione o tipo de aplicativo "Empresarial" e clique em "Avançar".

5. Preencha os detalhes do aplicativo:

   • Nome do aplicativo: Escolha um nome para seu aplicativo (ex: "Yuzap WhatsApp").

   • E-mail de contato do aplicativo: Seu endereço de e-mail.

   • Portfólio de negócios: Selecione sua conta empresarial da Meta verificada no menu suspenso. Se não tiver uma, você pode criar uma aqui, mas lembre-se de verificá-la depois.

6. Clique em "Criar aplicativo". Você pode ser solicitado a inserir sua senha do Facebook.

Passo 2: Adicione o WhatsApp ao seu Aplicativo

1. Após criar o aplicativo, você será direcionado ao painel do aplicativo.

2. Role para baixo até encontrar "WhatsApp" na lista de produtos e clique em "Configurar".

Passo 3: Configure um Token de Acesso Permanente da API do WhatsApp Cloud

Para manter uma conexão segura e ininterrupta, você precisará criar um Usuário do Sistema e gerar um token de acesso permanente.

1. Acesse as Configurações do Negócio da sua conta empresarial da Meta.
2. No menu à esquerda, vá para "Usuários" > "Usuários do sistema".

3. Clique em "Adicionar". Crie um novo usuário do sistema:

   • Nome do usuário do sistema: Dê um nome (ex: "Yuzap_API_User").

   • Função do usuário do sistema: Selecione "Admin".

   • Clique em "Criar usuário do sistema".

4. Com o novo usuário do sistema selecionado, clique em "Adicionar ativos".

5. Na janela pop-up:

   • Selecione "Aplicativos" na coluna da esquerda.

   • Escolha o aplicativo Meta que você criou no Passo 1.

   • Ative a opção "Controle total" em "Gerenciar aplicativo".

   • Clique em "Salvar alterações".

6. Retorne à página "Usuários do sistema", selecione o usuário recém-criado e clique em "Gerar novo token".

7. Na janela pop-up:

   • Selecione o aplicativo: Escolha o aplicativo Meta criado no Passo 1.

   • Definir expiração: Selecione "Nunca".

   • Atribuir permissões: Selecione as seguintes permissões:

     • whatsapp_business_management

     • whatsapp_business_messaging

     • business_management (Pode ser necessário se não encontrar as outras)

8. Clique em "Gerar token".

9. Copie e salve este token imediatamente em um local seguro. Este é o seu Token de Acesso Permanente (API Key). Você não poderá vê-lo novamente.

Passo 4: Configure a API do WhatsApp Cloud

1. Volte para o painel do seu aplicativo Meta (Meta for Developers > Meus Aplicativos > Seu App).
2. No menu à esquerda, vá para "WhatsApp" > "Configuração da API".

3. Conta Empresarial da Meta: Certifique-se de que sua conta empresarial verificada esteja selecionada.

4. Token de Acesso: Cole o Token de Acesso Permanente que você gerou no Passo 3.

5. Adicionar número de telefone: Clique em "Adicionar número de telefone".

   • Preencha as informações da sua empresa.

   • Insira o número de telefone que você deseja usar para o WhatsApp.

   • Verifique o número usando um código OTP (senha única) enviado por SMS ou ligação telefônica.

   • Observação: A Meta exige um número de telefone verificado para a configuração da API do WhatsApp.

6. Após adicionar e verificar seu número, ele aparecerá na seção "Enviar e receber mensagens".

Passo 5: Conecte sua Conta Yuzap

Agora, vamos conectar sua conta Yuzap com a API do WhatsApp Cloud.

1. Na página "Configuração da API" do seu aplicativo Meta, copie os seguintes IDs:

   • ID do número de telefone

   • ID da conta do WhatsApp Business (WABA ID)

2. Faça login na sua conta Yuzap.

3. Vá para Configurações > Caixas de Entrada > Adicionar Caixa de Entrada.

4. Selecione o canal "WhatsApp".

5. Preencha os detalhes da caixa de entrada:

   • Nome da Caixa de Entrada: Dê um nome para identificar esta caixa (ex: "Suporte WhatsApp").

   • Provedor: Selecione "WhatsApp Cloud".

   • Número de telefone: Insira o número de telefone verificado (incluindo o código do país, ex: +55119XXXXXXXX).

   • ID do número de telefone: Cole o ID copiado da Meta.

   • ID da conta do WhatsApp Business (WABA ID): Cole o ID copiado da Meta.

   • Chave da API: Cole o Token de Acesso Permanente que você salvou no Passo 3.

   • Clique em "Criar Canal WhatsApp".

6. Adicionar Agentes: Adicione os agentes que terão acesso a esta caixa de entrada.

7. Copie as informações do Webhook: Após adicionar agentes, você verá a URL do Webhook e o Token de Verificação do Webhook fornecidos pelo Yuzap. Copie ambos.

Passo 6: Configure seu Webhook na Meta

Precisamos configurar o webhook do WhatsApp na Meta para receber mensagens de clientes enviadas para o seu número comercial no Yuzap.

1. Volte para o painel do seu aplicativo Meta (Meta for Developers > Meus Aplicativos > Seu App).
2. No menu à esquerda, vá para "WhatsApp" > "Configuração".

3. Na seção "Webhooks", clique em "Editar".

4. Na janela pop-up:

   • URL de Callback: Cole a URL do Webhook copiada do Yuzap.

   • Token de Verificação: Cole o Token de Verificação do Webhook copiado do Yuzap.

   • Clique em "Verificar e salvar".

5. Após a verificação, ainda na seção "Webhooks", clique em "Gerenciar" ao lado de "Campos do Webhook".

6. Na janela pop-up, clique em "Inscrever-se" para o campo messages. Certifique-se de que messages esteja marcado.

7. Clique em "Concluído".

Parabéns! Seu canal do WhatsApp agora está configurado e conectado ao Yuzap. As mensagens enviadas para o seu número do WhatsApp aparecerão na caixa de entrada do Yuzap.

Observações Importantes

• Múltiplos Números/Caixas de Entrada: O Aplicativo Meta permite configurar apenas um único endpoint de Webhook. Portanto, crie caixas de entrada no Yuzap para todos os números conforme necessário. Você precisará configurar a URL do Webhook fornecida por apenas uma dessas caixas de entrada no aplicativo Meta para que todas as outras caixas de entrada funcionem.

• Modelos de Mensagem: Atualmente, o Yuzap suporta apenas modelos baseados em texto. Se o seu modelo tiver cabeçalhos de mídia ou componentes personalizados como botões, formulários, etc., eles não serão exibidos no seletor de modelos do Yuzap.

Quais tipos de mídia são suportados?

Tipo de Mídia	Extensões Suportadas	Nível de Suporte
Áudio	aac, mp4, mpeg, amr, ogg	Usuário final e agente
Documento	text/plain, PDF, PowerPoint, Word, Excel, DOCX, PPTX, XLSX	Usuário final e agente
Imagem	jpeg, png	Usuário final e agente
Vídeo	mp4, 3gp	mp4: Usuário final e agente 3gp: Apenas usuário final
Sticker	image/webp	Apenas usuário final

---

Referência: Adaptado da documentação do Chatwoot.