Uma API de WhatsApp permite que um sistema solicite operações por código, como preparar um envio a partir de um pedido ou receber eventos de uma conversa. Em uma API HTTP, seu programa envia uma requisição ao endereço documentado pelo fornecedor e interpreta a resposta.
A API pública do Blu está em fase de validação de interesse e ainda não está disponível para uso. Estamos recebendo pedidos para entender quais integrações devem vir primeiro. Os exemplos deste guia explicam o formato de uma integração; não são endpoints ou instruções de ativação de uma API já lançada.
Quero ser avisado sobre a API do Blu
Como funciona o envio por HTTP
O fluxo mais simples tem quatro partes:
Evento no seu sistema → requisição HTTP → resposta da API → acompanhamento do resultado
Imagine uma loja que prepara uma confirmação quando um pedido fica pronto. Seu sistema identifica o destinatário, monta o texto e chama a operação documentada pela integração. A resposta informa o resultado daquela chamada.
Uma resposta de sucesso não significa necessariamente que a mensagem foi entregue ou lida. Você precisa consultar os estados oferecidos pelo fornecedor e, quando disponíveis, acompanhar as atualizações por webhook.
| Parte da requisição | Para que serve |
|---|---|
| Endereço da operação | Indica qual recurso será chamado |
| Método HTTP | Define a operação, como um POST de envio |
| Autenticação | Identifica a integração autorizada |
| Corpo da requisição | Leva os dados necessários, como destinatário e texto |
Os nomes dos campos e a autenticação variam por API. Use sempre a documentação da versão que você estiver integrando.
Exemplo em Python: preparar os dados de uma mensagem
Este exemplo só monta e imprime um JSON localmente. Não envia mensagens, não usa credenciais e não representa um contrato da API do Blu. Os dados são fictícios.
import json
mensagem = {
"destinatario": "NUMERO_DE_TESTE",
"texto": "Seu pedido de exemplo está pronto para retirada.",
}
print(json.dumps(mensagem, ensure_ascii=False, indent=2))
Em uma integração real, você adaptaria esse conteúdo aos campos documentados e faria a requisição ao endereço fornecido pelo serviço. Python oferece recursos HTTP na biblioteca padrão, como urllib.request. O mesmo fluxo pode ser implementado em outras linguagens.
Antes de automatizar, teste um único caso, trate respostas de erro e registre o resultado. Guarde credenciais no ambiente de execução, e não em uma página pública ou em código compartilhado.
Para que servem os webhooks?
Um webhook permite receber avisos de eventos sem consultar a API repetidamente. Quando ocorre um evento, o serviço faz uma requisição para uma URL do seu sistema.
Em uma integração de mensagens, os eventos podem incluir uma nova mensagem ou uma mudança de estado de envio, conforme o que o fornecedor disponibiliza. Seu sistema valida a origem, registra o evento e decide a próxima ação.
Ao avaliar uma API, confira como ela identifica cada evento, autentica o webhook e repete notificações que falharam. Projete o processamento para não executar a mesma ação duas vezes ao receber uma repetição. A API pública do Blu ainda não tem um catálogo de webhooks liberado.
Quais integrações fazem sentido para o seu negócio?
Estes são exemplos de usos em avaliação, e não integrações prontas do Blu:
| Sistema | Gatilho proposto | Tarefa desejada |
|---|---|---|
| Loja virtual | Pedido pronto | Preparar uma atualização para o cliente |
| CRM | Mudança de etapa | Preparar um retorno sobre uma proposta |
| Agenda | Compromisso próximo | Organizar um lembrete |
| Sistema interno | Tarefa concluída | Avisar a equipe |
O objetivo da proposta do Blu é permitir que tarefas do sistema da empresa se conectem à operação de WhatsApp. Ao pedir acesso, informe o sistema que usa, o gatilho e o que espera receber de volta. Isso ajuda a priorizar uma integração concreta.
API de WhatsApp sem Meta: o que essa expressão significa?
A expressão costuma se referir a uma integração que não exige que o cliente configure diretamente a API oficial da Meta. Isso não significa que o WhatsApp deixe de ser um serviço da Meta nem que diferentes formas de conexão tenham as mesmas condições de uso.
A proposta da API do Blu é trabalhar com a conexão do número à plataforma. A forma final de autenticação, os recursos, os limites e as condições serão informados se o produto avançar para lançamento. Ainda não há chaves públicas, SDKs ou endpoints liberados para testar este guia.
API, CLI ou MCP?
Para código dentro de um sistema próprio, avalie uma API. Para scripts de terminal, veja como funciona um CLI para WhatsApp. Para pedir tarefas a um assistente de IA, leia sobre MCP para WhatsApp.
Se sua necessidade pode ser atendida pelo painel hoje, conheça a plataforma do Blu. O pedido de acesso à API registra interesse e não libera automaticamente uma integração.
Como participar da lista de interessados
Preencha o formulário e descreva um fluxo: “uso um CRM e quero preparar uma mensagem quando uma proposta for aprovada”, por exemplo. Ainda não há data confirmada de lançamento. Entrar na lista não exige contratar um plano.
