Esta publicação tem como objetivo demonstrar, de maneira resumida, como funciona uma API e como integrar o seu sistema utilizando a API do WhatsApp Bussiness.
O que é uma API?
Interface de Programação de Aplicação (API), é o conjunto de rotinas que permite que diferentes sistemas se comuniquem entre si. Ela é responsável por especificar os métodos e parâmetros que os desenvolvedores podem utilizar para solicitar e enviar informações entre si.
Na prática, o cliente envia uma solicitação com os parâmetros necessários para o endpoint da API através do protocolo http, o servidor executa a solicitação e retorna o Json contendo as informações solicitadas.
Exemplo de API no cotidiano
Uma API em um contexto prático, pode ser vista como um garçom em um restaurante. O cliente faz uma solicitação para o garçom, que comunica até a cozinha e, posteriormente, retorna à mesa com o prato solicitado. Este modelo de implementação permite com que diferentes serviços de diferentes sistemas interajam entre si sem precisar conhecer os detalhes da implementação um do outro.
Além disso, um fator essencial para o sucesso na implementação de uma API, tanto do lado do cliente quanto do servidor, é possuir uma documentação abrangente e precisa. Esta documentação não apenas serve para orientar os desenvolvedores sobre como utilizar a API, mas também fornece informações importantes sobre os parâmetros aceitos, endpoints e possíveis respostas.
Como funciona uma Requisição de API (API do WhatsApp)
A API do Whatsapp, chamada de “WhatsApp Business API” permite com que empresas se conectem no WhatsApp a fim de interagir com os clientes de forma automatizada e escalável. Combinando as tecnologias HTTP (Hypertext Transfer Protocol) para comunicação e Json (Javascript Object Notation) para formatação dos dados.
Para utilização do WhatsApp Business é necessário possuir um token de acesso que será utilizado para autorizar as requisições entre cliente e servidor. Estes são fornecidos através da própria ferramenta do WhatsApp Business. Uma vez autorizado já é possível realizar o envio de requisições ao servidor. Utilizando como exemplo um restaurante, imagine que o usuário realizou seu pedido através de uma plataforma web, onde previamente preencheu um cadastro básico contendo dados como seu nome e número de telefone. No momento em que clicou em “Concluir Pedido” o sistema enviou uma requisição para a API do WhatsApp e solicitou o envio de uma mensagem de texto para o usuário, confirmando que o pedido foi entregue para o restaurante. O exemplo abaixo ilustra esse cenário.
A API recebeu a requisição contendo o token de autorização, o Json contendo informações como número de telefone, número do pedido e a mensagem que deve ser enviada para o cliente. Após, o endpoint processou a informação e devolveu uma resposta contendo o status da execução da solicitação. O exemplo abaixo ilustra esse cenário.
Nessa hora a aplicação recebeu a confirmação, através do protocolo 200, que a mensagem foi enviada com sucesso. Empresas costumam possuir uma conta Business no WhatsApp só para tratar o envio de mensagens para clientes. Alguns, inclusive, não dependem de uma aplicação web para recebimento das informações, configuram no próprio WhatsApp a interpretação das mensagens redigidas pelos clientes para processar os retornos contendo o que foi solicitado. E isso tudo acontece graças aos envios de Requisições e Respostas intermediados por uma API.
Referências
O que é uma API? – Explicação sobre interfaces de programação de aplicações – AWS (amazon.com)
Central do desenvolvedor | WhatsApp Business
Introdução – API de Gerenciamento do WhatsApp Business (facebook.com)
Autor Eduardo Giachellin