respond-io
New
🚀 TikTok Business Messaging está no ar! Transforme as conversas em conversões perfeitamente. Saiba mais.arrow-icon

Casa >

Canais. >
WhatsApp >
API do WhatsApp Cloud

API do WhatsApp Cloud

Avatar
JQ Lee
· 23 Jul 2024
9 minutos de leitura

Agora, você pode migrar sua conta conectada do WhatsApp 360 para respond.io WhatsApp Business API para desfrutar de maior confiabilidade, custos mais baixos e acesso a novos recursos. Saiba mais sobre o processo de migração aqui.

Para conectar o WhatsApp Cloud API, é necessário um aplicativo do Facebook com o WhatsApp Product ativado. Leia este guia sobre como configurar seu aplicativo do Facebook.

O Facebook anunciou o lançamento da API do WhatsApp Cloud no dia 20 de Maio, e ela estará disponível para qualquer negócio de qualquer tamanho, grande e pequeno para se comunicar com os clientes usando a API oficial do WhatsApp.

Este canal tem uma janela de mensagens limitada por 24 horas devido aos regulamentos do WhatsApp. Saiba mais sobre a política de negócios do WhatsApp' aqui.

Conectando WhatsApp Cloud API

Assista o vídeo abaixo para um guia passo a passo em como conectar o WhatsApp Cloud API para respond.io.

Para conversar com seus clientes por meio da WhatsApp Cloud API, conecte um perfil Business do WhatsApp e uma conta da Meta Business.

Facebook App e conta Meta Business são necessárias e você deve ser o administrador de ambos para se conectar.

Passo 1:Navegar paraConfigurações do Espaço de Trabalho> CliqueAdicionar Canal

Etapa 2:Localize o canal da API do WhatsApp Cloud > Clique emConectar.

Passo 3: clique no botãoConectar com o Facebook.

Passo 4: Entre usando a conta do Facebook com acesso de administrador à conta de meta e aplicativo do Facebook.

Passo 5: Na lista suspensa selecione o nome WABA com o número do WhatsApp que deseja se conectar.

Etapa 6: adicione o URL de retorno de chamada. Volte para a seçãoWhatsAppno App do Desenvolvedor do Facebook. Navegue para a subseçãoConfiguraçãoe configure a URL de retorno de chamada. Adiciona a URL de Callback gerada e verifica o token de respond.io aos campos correspondentes no diálogo do webhook.

Passo 7: No aplicativo do Facebook, verifique e salve alterações no aplicativo.

Passo 8: Inscreva-se no evento webhook. No seu aplicativo do Facebook, selecione a guiaWebhooksno painelProductse selecioneWhatsApp Business Contana lista suspensa do WhatsApp Business. Clique em um evento de mensagens de assinatura.

Passo 9: Clique no botão no topo da página para ativar o modo de produção.

Lembre-se de preencher a URL da sua política de privacidade. Se estiver em branco, você não terá permissão para ativar o modo de produção.

Passo 10: Clique em Salvar Alterações para concluir a configuração.

Depois de'concluir a configuração, todas as mensagens enviadas para o seu número do WhatsApp serão recebidas no seu Workspace.

Configuração do Canal

Canal de API do WhatsApp em Nuvem pode ser configurado com um nome único.

Passo 1:Navegue paraConfigurações do Espaço de trabalho> CliqueCanais.

Etapa 2:Localize o canal da API do WhatsApp Cloud > Clique emGerenciar.

Etapa 3:Configure o nome do canal, que é usado internamente para identificar a conta.

Passo 4:CliqueSalvar Alterações para atualizar a configuração do canal.

Metadados recebidos pelo canal

Canais diferentes fornecem diferentes conjuntos de metadados do contato para respond.io plataforma. Aqui está a lista de dados que você poderá obter neste canal:

  • Número de telefone

  • ID do número de telefone

  • Nome Perfil

  • ID do Whatsapp

Gerenciando o perfil API do WhatsApp Cloud

Se for necessário fazer uma alteração ou conferir seu Perfil de API da API do WhatsApp Cloud, isso poderá ser feito na plataforma respond.io.

Passo 1:Navegue paraConfigurações do Espaço de trabalho> CliqueCanais.

Passo 2:Localize o canal API do WhatsApp Cloud > CliqueGerenciar > Perfil.

Passo 3: Clique em Sincronizar perfil para obter as informações mais recentes do Perfil de Negócios do WhatsApp no WhatsApp.

Passo 4: Editar as seguintes informações conforme necessário.

campos

Descrição

Foto do perfil

Imagem mostrada como a imagem de perfil da conta empresarial do WhatsApp. Recomenda-se um tamanho de imagem de 640x640x640.

SOBRE

O negócio'Sobre o texto. Este texto aparece no perfil empresarial'abaixo de sua imagem de perfil, número de telefone e botões de contato.

Endereço

Endereço da empresa Máximo de 256 caracteres.

Descrição

Descrição do negócio. Máximo de 512 caracteres.

e-mail

Endereço de e-mail (no formato de e-mail válido) para entrar em contato com a empresa. Máximo de 128 caracteres.

Vertical

Indústria dos negócios. Deve ser um desses valores aceitos: AutomotiveBeauty, Spa e SalonClothing e ApparelEducationEntertainmentEvent planejamento e serviçoFinanciamento e BankingFood e GroceryPublic ServiceHotel and LodgingMedical e HealthNon-profitsional ServicesShopping e Retail Travel e TransportationRestaurantOtherO negócio vertical não pode ser definido de volta a um valor vazio após ser criado.

site

URLs (incluindo http:// ou https://) associados à empresa (por exemplo, site, página do Facebook, Instagram). Máximo de 2 sites com no máximo 256 caracteres cada.

Passo 5: Revise a informação e clique em Salvar Alterações.

Gerenciar Modelos de Mensagens do WhatsApp

Antes de enviar um modelo de mensagem para um Contato na plataforma respond.io, certifique-se de que você've fez o seguinte:

- Enviado o modelo de mensagem para aprovação- Adicionado o modelo de mensagem aprovado ao espaço de trabalho sincronizando o modelo de mensagem

Submetendo Modelos de Mensagem

Passo 1:Navegue paraConfigurações do Espaço de trabalho> CliqueCanais.

Etapa 2:Localize o canal da API do WhatsApp Cloud > Clique emGerenciar.

Passo 3: Clique nos Modelos > Envie o 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 ( _ )

Categorias

A categoria à qual pertence o modelo de mensagem.

Idioma

O idioma no qual o modelo está escrito.

Passo 5: Crie a mensagem preenchendo os componentes necessários, depois revise a mensagem na seção de pré-visualização. Você pode incluir parâmetros 1, 2, etc. como espaços reservados para serem preenchidos com conteúdo personalizado.

Bloco de Construção

Descrição

Conteúdo

O corpo contém o texto mais importante do seu modelo. Somente o texto é suportado.Você pode usar o markdown para formatar o conteúdo deste bloco. Aprenda mais aqui.

Cabeçalho

O Cabeçalho é opcional e serve como o título ou cabeçalho do seu modelo. Ele suporta o seguinte:
- Texto
- Imagem
- Video
- Documento

* Resposta. a plataforma aceita uploads de até 20MB.

Rodapé

O Rodapé é opcional e apenas suporta texto. Pode ser usado para fornecer informações suplementares no seu modelo de mensagem.

Botão

O botão é opcional e adiciona interatividade aos seus modelos. Existem dois tipos disponíveis:
Call to Action Button
- Usado para enviar o seu cliente para um site ou chamar um Número de Telefone
- Máximo de uma URL e Número de Telefone por modelo
- A URL pode ter um parâmetro ou personalizationQuick

Responder Botão
- Usado para obter respostas rápidas do seu cliente
- Máximo 3 botões de resposta rápida por modelo
- Cada botão de resposta rápida não pode ter mais de 20 caracteres

* Botões de resposta rápida são suportados apenas em iOS, Plataforma Android e web, mas não na plataforma Windows. Consulte mais detalhes aqui.

Passo 6: Fornecer um valor de amostra

Isto só é aplicável se você tiver incluído qualquer parâmetro no conteúdo modelo de sua mensagem.

Fornecer valores de exemplo para o parâmetro no modelo de mensagem ajudará o revisor do WhatsApp a entender a mensagem que você está tentando enviar para seus Contatos.

Link importante: Orientações de Modelo de Mensagens do WhatsApp

Sincronizando Modelos de Mensagem

Passo 1:Navegue paraConfigurações do Espaço de trabalho> CliqueCanais.

Etapa 2:Localize o canal da plataforma WhatsApp Business (API) > Clique emGerenciar.

Passo 3: Clique em Modelos > Sincronizar o modelo para iniciar o processo de sincronização.

O processo de sincronização foi concluído. Isso significa que:

- Os modelos de mensagem serão listados com seus status correspondentes.- A última data sincronizada será atualizada. Se o seu modelo for rejeitado, o motivo da rejeição será exibido abaixo do modelo de mensagem rejeitada.

A tabela a seguir lista os status possíveis para os modelos de mensagem:

SItuação

Descrição

Enviado

O modelo de mensagem é enviado e pendente de aprovação.

Aceito

O modelo de mensagem foi aprovado e pode ser enviado para contatos.

Rejeitados

O modelo de mensagem é rejeitado e não pode ser usado.

Use a pesquisa e o filtro no canto superior direito do anúncio para encontrar facilmente seus templates!

Tipos de arquivo suportados

O tipo de arquivo suportado pelo WhatsApp e o tamanho máximo de arquivo para o tipo é o seguinte:

  • Áudio & Vídeo (16MB)

  • Documento (100 MB)

  • Imagem (5 MB)

  • Adesivo (100 KB)

Mensagens que não são suportadas terão uma alternativa com uma mensagem não suportada ou texto e tipo de carga personalizada (se disponível). Para qualquer tipo de arquivo ou arquivo não suportado que exceda o tamanho máximo de arquivos enviados via WhatsApp Cloud API, o arquivo será automaticamente transformado em um link de URL na resposta. a plataforma. Para Payload personalizado, você pode clicar em Mostrar maispara visualizar o payload JSON desta mensagem. Exemplos de mensagens não suportadas para o WhatsApp Cloud API são:
- Contact Card
- Reactions
- Deletar Mensagem
- Enquetes
- Mensagem Ephemeral

Avaliar limites

Um limite de taxa é o número de chamadas de API um aplicativo 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.

FAQ e Solução de Problemas

Não foi possível enviar mensagens

Certifique-se de que o número que você'conectou à plataforma é um número da API do WhatsApp Cloud.

Mensagens não estão chegando

Isso pode acontecer quando o webhook de mensagens não é inscrito.

Passo 1: Navegue para a página de Webhook do App do Facebook

Abra o App do Facebook e navegue para a página Webhooks.

Passo 2: Verificar o evento de assinatura

Selecione Conta de Empresa do WhatsApp e verifique se o evento mensagens é inscrito.

Passo 3: Enviar uma mensagem de teste

Envie uma mensagem de teste para o número de telefone do WhatsApp e verifique se ele chegou.

Não foi possível receber recibos de leitura

Quando o usuário conectado à API da Nuvem do WhatsApp alterar sua senha do Facebook, as permissões ficarão desatualizadas e precisam ser atualizadas.

Passo 1:Navegue paraConfigurações do Espaço de trabalho> CliqueCanais.

Etapa 2:Localize o canal da plataforma WhatsApp Business (API) > Clique emGerenciar.

UPasso 3: Clique em Troubleshoot >Atualizar permissãopara atualizar as permissões do WhatsApp.

Passo 4: Envie uma mensagem de teste para o número de telefone do WhatsApp e verifique se ele chegou.

Não foi possível enviar mensagens de saída: Validando erro de token de acesso

Isso pode acontecer devido a alguns motivos:

  • Quando a sessão para validar o token de acesso expirar.

  • Houve uma alteração no privilégio de administrador do usuário'no Meta Business Manager.

  • Houve uma alteração de senha no Meta Business Manager.

Para resolver esse erro, você deve atualizar as permissões do canal da API do WhatsApp Cloud e enviar uma mensagem de teste novamente.

Você deve ser o administrador do Meta Business Manager para ser capaz de atualizar a permissão.

Contacte Não Recebendo Mensagens

Isso pode acontecer quando o Contato não concordou com os termos do WhatsApp e a política de privacidade.

Caso seus Contatos não possam receber mensagens de seu número da API da nuvem do WhatsApp, certifique-se de que eles concordaram com os termos e a política de privacidade mais recentes do WhatsApp.

Quais são os requisitos para o número de telefone a ser usado para se inscrever na API do WhatsApp Cloud?

  • O número de telefone usado na API da nuvem do WhatsApp pode ser't no aplicativo pessoal do WhatsApp ou empresarial. Você'terá que excluir a conta no aplicativo pessoal ou empresarial do WhatsApp antes de usar o número para se inscrever em uma API do WhatsApp Cloud.

  • Você ainda pode usar o número para outras finalidades, como chamadas e receber SMS depois de registrá-lo na Plataforma de Negócios do WhatsApp.

  • Depois de usar o telefone da API do WhatsApp em nuvem, você não poderá mais usar esse número no App Business do WhatsApp.

A Verificação de Negócios é necessária para começar a usar a API nuvem?

Não é obrigatório concluir a Verificação de Negócios do Facebook para começar a enviar mensagens no WhatsApp. Sem a verificação de negócio, a sua empresa ainda poderá:

  • Responder a conversas iniciadas por usuários ilimitados.

  • Envie conversas iniciadas por empresas (modelos de mensagem) para 250 clientes exclusivos em um período de 24 horas consecutivas.

  • Registrar até dois números de telefone.

As empresas só podem iniciar a Verificação de Negócios quando'estão prontas para realizar conversas iniciadas por empresas ou querem se tornar uma Conta Empresarial Oficial.

Posso ver as minhas dicas de conversa da minha conta de negócios do WhatsApp?

Sim, você pode monitorar sua análise de mensagens e gastos em tempo real para sua conta empresarial do WhatsApp na aba Insights do seu gerenciador Meta WhatsApp. 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 por negócios 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 pelo negócio inicia quando a primeira mensagem é entregue a um cliente e termina 24 horas mais tarde. Leia mais aqui.

Como faço para adicionar um método de pagamento à minha conta do WhatsApp Business?

Você pode adicionar um método de pagamento à sua conta do WhatsApp Business no Business Manager. Saiba como adicionar um método de pagamento à sua conta empresarial do WhatsApp aqui.

Por que minha mensagem não foi enviada com um erro "Problema de pagamento de elegibilidade de negócios"?

Isto é muito provável devido a você ter excedido o limite mensal de níveis livres sem um método de pagamento válido. Para resolver esse problema, adicione um método de pagamento válido.

Quais são os preços da API do WhatsApp Cloud?

A API do WhatsApp usa um modelo de preços baseado em conversa, que cobra as empresas pelo número de conversas que têm. Uma conversa começa quando sua empresa' mensagem é entregue a um cliente e dura por uma janela de atendimento ao cliente 24 horas, , durante o qual qualquer número de mensagens pode ser trocado entre o cliente e o negócio. As empresas cobram custos por cada conversa, independentemente de quantas mensagens são enviadas ou recebidas dentro dessa janela de atendimento ao cliente.

Saiba mais sobre o WhatsApp Pricing aqui.

Como faço para excluir um número de telefone de uma conta corporativa?

Existem alguns requisitos e etapas necessários para excluir um número de telefone, leia mais aqui.

Posso usar respond.io para enviar uma transmissão da API da WhatsApp Cloud com o número do meta teste?

Você pode enviar uma transmissão de teste a partir da plataforma usando o número de meta teste. No entanto, uma transmissão usando o número de teste é limitada a cinco destinatários. Primeiro você deve adicionar esses cinco destinatários à lista de número de telefone nas ferramentas do Meta Desenvolvedor.

Se não adicionar destinatários a esta lista ou se você tentar enviar uma transmissão para destinatários que não estão nesta lista, você receberá essa mensagem de erro:

Posso excluir o número de Meta test da minha conta da Cloud API?

Não, este número é fornecido automaticamente a todas as contas para enviar mensagens de teste e não pode ser excluído. Apenas tenha o cuidado de observar que este é um número de teste que não deve ser utilizado para outros fins.

Por que vejo Contatos duplicados do mesmo canal do WhatsApp?

WhatsApp passa o número de telefone do Contato em um formato que é diferente do formato E.164 que respond.io usa. Esta diferença faz com que os Contatos de certos países sejam duplicados. Se isso ocorrer, entre em contato conosco aqui.

Como faço para alterar meu nome de exibição da API nuvem?

Para alterar o nome de exibição da sua API na nuvem, siga estas etapas:

  1. Navegue até a sua conta FBM > WhatsApp > Número de telefone. Esta página exibe seu limite de mensagens e qualidade.

  2. Passe o mouse sobre o ícone do lápis ao lado do nome de exibição para ativar a edição.

  3. Clique em Próximo para enviar seu novo nome de exibição para aprovação.

  4. Esperar confirmação da aprovação de Meta.

Que passos devo tomar depois que meu novo nome de exibição para minha API em nuvem for aprovado?

Depois de receber a aprovação do Meta para o seu novo nome de exibição, conclua os seguintes passos:

  1. Reregistre seu número de telefone usando o nome de exibição recém-aprovado.

  2. Execute uma chamada de API POST para verifique seu número de telefone.

  3. Faça outra chamada POST API para registrar novamente o número de telefone verificado.

  4. Depois de concluída a atualização do nome da sua API na nuvem'

Por que encontrei o erro "Erro ao validar o token de acesso: A sessão foi invalidada porque o usuário alterou sua senha ou o Facebook alterou a sessão por razões de segurança" ao tentar enviar uma mensagem?

Este erro ocorrerá se você atualizou recentemente suas credenciais do Facebook, pode interromper a conexão do Canal na nossa plataforma, levando a erros ao enviar mensagens.

Para resolver esse problema, você precisa atualizar as permissões de canal em nossa plataforma usando 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.

Compartilhar este artigo
Telegram
Facebook
Linkedin
Twitter

Artigos relacionados 👩‍💻

Inicialização rápida da Plataforma de Negócios do WhatsApp (API)
Obtenha uma conta API do WhatsApp Business rapidamente para começar a conversar com seus clientes.
API de chamadas comerciais do WhatsApp
Aprenda a usar a API de chamadas do WhatsApp Business para receber e fazer chamadas.
Migração de número de telefone para a plataforma WhatsApp Business (API) do respond.io
Aprenda como migrar seu número de telefone de outros BSPs para a API do WhatsApp Business do respond.io.
Preparando-se para receber conversas
Saiba mais sobre as janelas de conversa, envie modelos de mensagens e defina um ponto de entrada simples para gerenciar as mensagens do WhatsApp de seus clientes.
Modelo de mensagem WhatsApp
Use os Modelos de Mensagens do WhatsApp para entrar em contato a qualquer momento.

Não consegue encontrar o que você está procurando? 🔎