WhatsApp API Hyperflow

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

Sua conta precisa de uma liberação prévia para usar este recurso. Caso queria saber mais informações, entre em contato com o seu CS.

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.html, e em seguida, ir na aba "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

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.

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-hyperflow

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.

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"

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:

cURL

curl --location 'https://messaging.hyperflowapis.global/whatsapp/send-message' \
--header 'apikey: hf-SUA_CHAVE_OBTIDA_NA_IMAGEM_04' \
--header 'Content-Type: application/json' \
--data '{
  "to": "5534992611858",
  "type": "text",
  "payload": {
    "text": "Olá, teste WhatsApp API Hyperflow!"
  }
}'

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..).

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.

Sucesso! 🎉

Agora você sabe como utilizar e manipular a WhatsApp API da Hyperflow! Caso tenha qualquer dúvida, pode chamar o nosso time de suporte que estará pronto para lhe ajudar!