whatsappWhatsApp API Hyperflow

Use esta documentação para realizar a conexão com a API do WhatsApp através da Hyperflow

circle-exclamation

Para quem é essa API?

Esta API é recomendada para pessoas que possuem conhecimento técnico para realizar a integração entre sistemas.

Ela só deve ser utilizada, caso você não queira utilizar os módulos de Integrações e Conversas da Hyperflow, ou seja, você deseja apenas acesso a API oficial do WhatsApp, e irá realizar todo controle e integração do seu lado com o seu time ténico.

Acessando a API

Para acessar as configurações da WhatsApp API Hyperflow, basta acessar https://integracoes.hyperflow.global/index.htmlarrow-up-right, e em seguida, ir na aba "Contas de WhatsApp"

Menu contas de WhatsApp
Imagem 01 - Acessando o menu Contas de WhatsApp

Em seguida, clique no botão para adicionar contas de WhatsApp e você poderá escolher um número de teste fornecido pela Hyperflow para testar a API e começar a criar as suas integrações

Criar número de teste para WhatsApp API Hyperflow
Imagem 02 - Criando um número de teste para a WhatsApp API Hyperflow

Agora que você possui um número de teste, você poderá ver e editar os dados do número, ou consultar a documentação completa do Postman com todos os métodos e payloads disponíveis da WhatsApp API Hyperflow.

Número de teste conectado na WhatsApp API Hyperflow
Imagem 03 - Número de teste conectado na WhatsApp API Hyperflow e link para documentação

Se preferir, você também já pode acessar a documentação completa com todos os payloads e webhooks, clicando neste link: https://www.postman.com/hyperflow-global/whatsapp-business-api-hyperflowarrow-up-right

Usando o número de teste

O número de teste fornecido pela Hyperflow é um número compartilhado. Por conta disso, para iniciar os seus testes, você precisará primeiro enviar uma palavra chave para o número. Uma vez feito isso, a sua sessão é vinculada ao número de teste, e você poderá usar ele para manipular a API.

Basta clicar no link fornecido para já abrir o número de teste com a mensagem pré-populada e iniciar os seus testes.

Você também pode usar esta tela para configurar a sua URL de webhook de novas mensagens e status de mensagem.

Tela de configuração do número de teste
Imagem 04 - Tela para configurar os dados e obter o token do seu número de teste

Envie a mensagem para o número de teste. Será uma mensagem do tipo "proxy ID_DO_SEU_AMBIENTE"

Mensagem para ativar o broker Hyperflow
Imagem 05 - Envio de mensagem para habilitar o uso da WhatsApp API Hyperflow no número de teste

Uma vez enviada esta mensagem, você poderá chamar os métodos da API normalmente.

Exemplo de chamada para envio de texto:

Pronto! Sua mensagem será enviada com sucesso para o número inserido na propriedade "to" do payload.

Recebendo webhooks

Se você configurou uma URL para recebimentos dos webhooks de mensagens e status, ela passará a ser notificada sempre que tiver uma nova mensagem ou atualização de status de mensagem (lido, entregue, etc..).

Exemplo de payload recebido via webhook
Imagem 06 - Exemplo de webhook recebido do número de teste da WhatsApp API Hyperflow

Você pode consultar todos os modelos de webhooks e regras pelo link da nossa documentação do Postman.

circle-check

Last updated