Agora pode migrar a sua conta do WhatsApp 360dialog conectada para a API do WhatsApp Business do respond.io para tirar partido de uma maior fiabilidade, custos mais baixos e acesso a novas funcionalidades. Saiba mais sobre o processo de migração aqui.
Para ligar a API do WhatsApp Cloud, é necessário uma aplicação do Facebook com o produto WhatsApp ativado. Leia este guia sobre como configurar a sua aplicação do Facebook.
O Facebook anunciou o lançamento da API do WhatsApp Cloud no dia 20 de maio, e está disponível para qualquer empresa de qualquer tamanho, grande ou pequena, para comunicar com os clientes utilizando a API oficial do WhatsApp.
Este canal tem uma janela de mensagens limitada a 24 horas devido às regulamentações do WhatsApp. Saiba mais sobre a política comercial do WhatsApp' aqui.
Ligar a API do WhatsApp Cloud
Veja o vídeo abaixo para obter um guia passo a passo sobre como ligar a API do WhatsApp Cloud ao respond.io.
Para conversar com os seus clientes através da API WhatsApp Cloud, ligue um Perfil Comercial WhatsApp e uma Conta Meta Comercial.
A aplicação do Facebook e a conta Meta Business são necessárias e tem de ser o administrador de ambas para se ligar.
Passo 1:Navegue atéDefinições do espaço de trabalho> Clique emAdicionar canal
Passo 2:Localizar o canal API do WhatsApp Cloud > Clique emLigar.
Passo 3: Clique no botãoLigar com o Facebook.
Passo 4: Inicie sessão utilizando a conta do Facebook com acesso de administrador à aplicação do Facebook e à conta comercial do Meta.
Passo 5: Na lista pendente, selecione o nome WABA com o número de WhatsApp que gostaria de ligar.
Passo 6: adicione o URL de retorno de chamada. Volte à secçãoWhatsAppna aplicação de programador do Facebook. Navegue até à subsecçãoConfiguraçãoe configure o URL de retorno de chamada. Adicione o URL de retorno de chamada gerado e verifique o token do respond.io nos campos correspondentes na caixa de diálogo do webhook.
Passo 7: Na aplicação do Facebook, verifique e guarde as alterações na aplicação.
Passo 8: inscreva-se no evento webhook. Na sua aplicação do Facebook, selecione o separadorWebhooksno painelProdutose selecioneConta comercial WhatsAppna lista pendente. Clique em inscrever-se nos eventos de mensagens.
Passo 9: Clique na alternância na parte superior da página para ativar o modo ao vivo.
Lembre-se de preencher o URL da sua política de privacidade. Se estiver em branco, não poderá ativar o modo ao vivo.
Passo 10: Clique em Guardar alterações para concluir a configuração.
Uma vez concluída a configuração, todas as mensagens enviadas para o seu número WhatsApp serão recebidas no seu Espaço de Trabalho.
Configuração de canal
O canal API do WhatsApp Cloud pode ser configurado com um nome de canal exclusivo.
Passo 1: Navegue para Configurações do Espaço de Trabalho > Clique em Canais.
Passo 2: Localize o canal da API do WhatsApp Cloud > Clique em Gerir.
Passo 3:Configure o nome do canal, que é utilizado internamente para identificar a conta.
Passo 4:Clique emGuardar alterações para atualizar a configuração do canal.
Metadados recebidos pelo canal
Diferentes canais fornecem diferentes conjuntos de metadados do Contacto para a plataforma respond.io. Eis a lista de dados de contacto que poderá obter neste canal:
Número de telefone
ID do número de telefone
Nome do perfil
ID Whatsapp
Gerir o perfil da API do WhatsApp Cloud
Caso seja necessário fazer alguma alteração ou verificar o seu perfil da API do WhatsApp Cloud, tal pode ser feito na plataforma respond.io.
Passo 1:Navegue atéDefinições do espaço de trabalho> Clique emCanais.
Passo 2:Localizar o canal API do WhatsApp Cloud > Clique emGerir > Perfil.
Passo 3: Clique em Sincronizar perfil para obter as informações mais recentes do perfil comercial do WhatsApp.
Passo 4: edite as seguintes informações, conforme necessário.
Campos | Descrição |
|---|---|
Foto de perfil | Imagem apresentada como foto de perfil da conta comercial do WhatsApp. Recomenda-se um tamanho de imagem de 640x640. |
Sobre | O texto Sobre o negócio'. Este texto aparece no perfil da empresa'por baixo da imagem de perfil, número de telefone e botões de contacto. |
Morada | Endereço da empresa. Máximo de 256 caracteres. |
Descrição | Descrição do negócio. Máximo de 512 caracteres. |
Endereço de e-mail (em formato de e-mail válido) para contactar a empresa. Máximo de 128 caracteres. | |
Vertical | Setor empresarial. Deve ser um destes valores aceites:AutomóvelBeleza, Spa e SalãoVestuário e AcessóriosEducaçãoEntretenimentoPlaneamento e Serviços de EventosFinanças e BancosAlimentos e MerceariaServiço PúblicoHotel e AlojamentoMedicina e SaúdeSem Fins LucrativosServiços ProfissionaisCompras e RetalhoViagens e TransportesRestauranteOutroO setor vertical de negócios não pode ser definido como um valor vazio após ser criado. |
Site | URLs (incluindo http:// ou https://) associados ao negócio (por exemplo, website, página de Facebook, Instagram). Máximo de 2 sites com um máximo de 256 caracteres cada. |
Passo 5: Reveja as informações e clique em Guardar alterações.
Gerir modelos de mensagens do WhatsApp
Antes de enviar um modelo de mensagem para um Contato na plataforma respond.io, certifique-se de que você fez o seguinte:
- Enviou o modelo de mensagem para aprovação - Adicionou o modelo de mensagem aprovado ao Workspace sincronizando o modelo de mensagem
Envio de modelos de mensagens
Passo 1:Navegue atéDefinições do espaço de trabalho> Clique emCanais.
Passo 2:Localizar o canal API do WhatsApp Cloud > Clique emGerir.
Passo 3: clique em Modelos > Enviar modelo para enviar um modelo de mensagem para aprovação.
Passo 4: Preencha as informações necessárias para criar um modelo.
Campo | Descrição |
|---|---|
Nome do modelo | O nome só pode conter caracteres alfanuméricos minúsculos e sublinhados ( _ ) |
Categoria | A categoria a que pertence o modelo de mensagem. |
Idioma | O idioma em que o modelo foi escrito. |
Passo 5: Crie a mensagem preenchendo os componentes necessários e, em seguida, reveja a mensagem na secção de pré-visualização. Pode incluir os parâmetros {{1}}, {{2}}, etc. como marcadores de posição para serem preenchidos com conteúdo personalizado.
Bloco de construção | Descrição |
|---|---|
Corpo | O Corpo contém o texto mais importante do seu modelo. Apenas texto é suportado. Pode utilizar o markdown para formatar o conteúdo deste bloco. Saiba mais aqui. |
Cabeçalho | O cabeçalho é opcional e serve como título ou cabeçalho do seu modelo. Suporta o seguinte: |
Rodapé | O rodapé é opcional e suporta apenas texto. Pode ser utilizado para fornecer informações complementares no seu modelo de mensagem. |
Botão | O botão é opcional e acrescenta interatividade aos seus modelos. Existem dois tipos disponíveis: |
Passo 6: Forneça o valor da amostra
Isto só é aplicável se tiver incluído algum parâmetro no conteúdo do seu modelo de mensagens.
Fornecer valores de exemplo para o parâmetro no modelo de mensagem ajudará o revisor do WhatsApp a compreender a mensagem que está a tentar enviar aos seus contactos.
Link importante: Orientações para os modelos de mensagens do WhatsApp
Sincronizando modelos de mensagens
Passo 1:Navegue atéDefinições do espaço de trabalho> Clique emCanais.
Passo 2:Localize o canal WhatsApp Business Platform (API) > Clique emGerir.
Passo 3: Clique em Modelos > Sincronizar modelo para iniciar o processo de sincronização.
O processo de sincronização foi concluído. Isto significa:
- Os modelos de mensagem serão listados com os seus estados correspondentes.- A data e hora da última sincronização serão atualizadas.- Se o seu modelo for rejeitado, o motivo da rejeição será apresentado por baixo do modelo de mensagem rejeitado.
A tabela seguinte lista os possíveis estados para os modelos de mensagens:
Estatuto | Descrição |
|---|---|
Enviado | O modelo de mensagem foi enviado e aguarda aprovação. |
Aprovado | O modelo de mensagem foi aprovado e pode ser enviado para os contactos. |
Rejeitado | O modelo de mensagem foi rejeitado e não pode ser utilizado. |
Utilize a pesquisa e o filtro no canto superior direito da lista para encontrar seus modelos facilmente!
Tipos de arquivos suportados
O tipo de arquivo suportado pelo WhatsApp e o tamanho máximo de arquivo para esse tipo são os seguintes:
Áudio e Vídeo (16 MB)
Documento (100 MB)
Imagem (5 MB)
Adesivo (100 KB)
As mensagens que não são suportadas terão uma apresentação de fallback com o texto Mensagem Não Suportada ou Carga Útil Personalizada e Tipo (se disponível). Para qualquer tipo de arquivo não suportado ou arquivo que exceda o tamanho máximo de arquivo enviado através da API do WhatsApp Cloud, o arquivo será automaticamente transformado em um link URL na plataforma respond.io. Para o Payload personalizado, você pode clicar em Mostrar mais para visualizar o payload JSON desta mensagem. Exemplos de mensagens não suportadas pela API do WhatsApp Cloud são:
- Cartão de Contato
- Reações
- Mensagem excluída
- Sondagens
- Mensagem efêmera
Limites de taxa
Um limite de taxa é o número de chamadas de API que uma aplicação ou usuário pode fazer dentro de um determinado período de tempo definido pelo canal. Saiba mais sobre os limites de taxa para este canal aqui.
Perguntas frequentes e resolução de problemas
Não é possível enviar mensagens
Certifique-se de que o número que você conectou à plataforma é um número da API do WhatsApp Cloud.
As mensagens não estão chegando
Isto pode acontecer quando o webhook de mensagens não está inscrito.
Passo 1: Navegue até a página Webhook do aplicativo do Facebook.
Abra o Facebook App e navegue até a página Webhooks.
Passo 2: Verifique o evento inscrito.
Selecione Conta comercial WhatsApp e verifique se o evento mensagens está inscrito.
Passo 3: Envie uma mensagem de teste.
Envie uma mensagem de teste para o número de telefone WhatsApp e verifique se chegou.
Não é possível receber confirmações de leitura.
Quando o usuário conectado à API do WhatsApp Cloud altera a sua senha do Facebook, as permissões ficam desatualizadas e precisam ser atualizadas.
Passo 1: Navegue até Configurações do espaço de trabalho > Clique em Canais.
Passo 2: Localize o canal da Plataforma WhatsApp Business (API) > Clique em Gerir.
Passo 3: Clique em Resolução de Problemas > Atualizar Permissão para atualizar as permissões do WhatsApp.
Passo 4: Envie uma mensagem de teste para o número de telefone WhatsApp e verifique se chegou.
Não é possível enviar mensagens de saída: erro de validação do token de acesso
Isto pode acontecer por alguns motivos:
Quando a sessão para validação do token de acesso expirar.
Houve uma alteração no privilégio de administrador do utilizador'no Meta Business Manager.
Houve uma alteração de palavra-passe no Meta Business Manager.
Para resolver este erro, deve atualizar as permissões do canal da API do WhatsApp Cloud e enviar novamente uma mensagem de teste.
Tem de ser o administrador do Meta Business Manager para poder atualizar a permissão.
Contacto não está a receber mensagens
Isto pode acontecer quando o contacto não concorda com os termos e a política de privacidade do WhatsApp.
Se os seus contactos não conseguirem receber mensagens do seu número da API do WhatsApp Cloud, certifique-se de que concordaram com os termos e a política de privacidade mais recentes do WhatsApp.
Quais são os requisitos para que o número de telefone seja utilizado para se inscrever na API do WhatsApp Cloud?
O número de telefone usado para a API do WhatsApp Cloud não pode ser utilizado no aplicativo pessoal ou comercial do WhatsApp. Terá que excluir a conta do aplicativo pessoal ou comercial do WhatsApp antes de poder usar o número para se inscrever na API do WhatsApp Cloud.
Pode ainda utilizar o número para outros fins, como ligar e receber SMS, após o registo na plataforma WhatsApp Business.
Depois de utilizar um telefone para a API do WhatsApp Cloud, já não poderá utilizar esse número na aplicação WhatsApp Business.
A Verificação Comercial é necessária para começar a utilizar a Cloud API?
Não é obrigatório completar a Verificação Comercial do Facebook para começar a enviar mensagens no WhatsApp. Sem a verificação empresarial, a sua empresa poderá ainda:
Responda a conversas ilimitadas iniciadas pelos utilizadores.
Envie conversas iniciadas pela empresa (modelos de mensagens) para 250 clientes exclusivos num período contínuo de 24 horas.
Registe até 2 números de telefone.
As empresas podem iniciar a Verificação Comercial apenas quando estão prontas para escalar conversas iniciadas por negócios ou querem se tornar uma Conta Comercial Oficial.
Posso visualizar os insights das minhas conversas na minha conta WhatsApp Business?
Sim, pode monitorizar as suas mensagens e análises de despesas em tempo real para a sua conta comercial do WhatsApp no separador Insights do seu Meta WhatsApp Manager. Leia mais aqui.
Quais são os limites de mensagens do WhatsApp?
Os limites de mensagens determinam o número máximo de conversas iniciadas pela empresa que cada número de telefone pode enviar em um período de 24 horas. Estes limites não se aplicam a conversas iniciadas pelo usuário. Uma conversa iniciada por uma empresa começa quando a primeira mensagem é entregue a um cliente e termina 24 horas depois. Leia mais aqui.
Como adiciono um método de pagamento à minha conta comercial do WhatsApp?
Pode adicionar um método de pagamento à sua conta WhatsApp Business no Gestor de Negócios. Saiba como adicionar um método de pagamento à sua conta comercial do WhatsApp aqui.
Porque é que a minha mensagem não foi enviada com o erro "Problema de pagamento de elegibilidade comercial"?
Provavelmente, isto ocorreu porque excedeu o limite do plano mensal gratuito sem um método de pagamento válido. Para resolver este problema, adicione um método de pagamento válido.
Qual é o preço da API do WhatsApp Cloud?
A API do WhatsApp utiliza um modelo de preços baseado em conversas que cobra às empresas pelo número de conversas que têm. Uma conversa começa quando a sua mensagem comercial' é entregue a um cliente e dura 24 horas janela de atendimento ao cliente, durante a qual qualquer número de mensagens pode ser trocado entre o cliente e a empresa. As empresas incorrem em cobranças por cada conversa individual, independentemente do número de mensagens que são enviadas ou recebidas dentro desse período de atendimento ao cliente.
Saiba mais sobre os preços do WhatsApp aqui.
Como elimino um número de telefone de uma conta empresarial?
Existem alguns requisitos e passos necessários para eliminar um número de telefone, leia mais aqui.
Posso utilizar o respond.io para enviar uma transmissão da API do WhatsApp Cloud com o número de teste Meta?
Pode enviar uma transmissão de teste da plataforma utilizando o número de teste Meta. No entanto, uma transmissão que utilize o número de teste está limitada a cinco destinatários. Primeiro deve adicionar estes cinco destinatários à lista de números de telefone nas ferramentas do Meta Developer.
Se não adicionar destinatários a esta lista ou se tentar enviar uma transmissão para destinatários que não estejam nesta lista, receberá esta mensagem de erro:
Posso eliminar o número do teste Meta da minha conta Cloud API ligada?
Não, este número é fornecido automaticamente a todas as contas para utilização no envio de mensagens de teste e não pode ser eliminado. Tenha apenas o cuidado de notar que este é um número de teste e não deve ser utilizado para outros fins.
Porque vejo contactos duplicados do mesmo canal do WhatsApp?
O WhatsApp passa o número de telefone do contacto em , um formato diferente do formato E. 164 utilizado pelo respond.io. Esta diferença faz com que os contactos de determinados países sejam duplicados. Se isso ocorrer, entre em contato conosco aqui.
Como altero o nome de visualização da minha API Cloud?
Para alterar o nome de apresentação da sua API Cloud, siga os seguintes passos:
Navegue até à sua conta WhatsApp FBM > > Número de telefone. Esta página exibe o seu limite e qualidade de mensagens.
Passe o rato sobre o ícone do lápis ao lado do nome de visualização para ativar a edição.
Clique em Seguinte para submeter o seu novo nome de utilizador ao Meta para aprovação.
Aguarde a confirmação da aprovação da Meta.
Que passos devo seguir depois de o meu novo Nome de Exibição para a minha API de Nuvem ser aprovado?
Após receber a aprovação da Meta para o seu novo nome de utilizador, conclua os seguintes passos:
Registe novamente o seu número de telefone utilizando o nome de utilizador recém-aprovado.
Execute uma chamada API POST para verificar o seu número de telefone.
Faça outra chamada POST API para e registe novamente o número de telefone verificado.
Após o sucesso, a atualização do nome de visualização da sua API Cloud'estará concluída.
Porque encontrei o erro "Erro ao validar o token de acesso: A sessão foi invalidada porque o utilizador alterou a sua palavra-passe ou o Facebook alterou a sessão por motivos de segurança" ao tentar enviar uma mensagem?
Este erro ocorrerá se tiver atualizado recentemente as suas credenciais do Facebook e poderá interromper a ligação do canal na nossa plataforma, causando erros ao enviar mensagens.
Para resolver este problema, precisa de atualizar as permissões do canal na nossa plataforma utilizando as suas credenciais atualizadas do Facebook. Este processo requer um papel de administrador. Ao atualizar as permissões, você restabelecerá a conexão com as novas credenciais, garantindo que suas mensagens de saída sejam enviadas com sucesso sem encontrar erros.
