1. Visão Geral
A integração do BNWEB com o WhatsApp permite automatizar o envio de notificações aos usuários da biblioteca, modernizando a comunicação e aumentando a eficiência na recuperação de acervos.
Com esta funcionalidade ativa, o sistema pode disparar mensagens automáticas para eventos como:
- Avisos de livros disponíveis (reservas atendidas).
- Lembretes de devolução iminente.
- Cobrança de materiais em atraso.
- Comprovantes de empréstimo e renovação.
- Outras …
2. Tarefas, Responsabilidade e Custos
É fundamental compreender a divisão de tarefas e responsabilidades nesta integração para o planejamento financeiro e técnico da instituição.
O que o BNWEB oferece (Sem Custos)
A funcionalidade de geração de mensagens faz parte do pacote padrão do BNWEB.
Custo BNWEB: R$ 0,00. Não há cobrança de licenciamento adicional por parte do BNWEB para habilitar o módulo de saída de notificações.
O que o sistema faz: O BNWEB processa as regras de negócio (ex: “quem está atrasado hoje?”) e envia os dados (telefone e texto) para uma “porta de saída” (API/Webhook).
O que a Instituição deve providenciar (Custo Externo)
Para que a mensagem saia do BNWEB e chegue ao celular do usuário, é necessária uma via de transporte. O BNWEB não se conecta diretamente aos servidores da Meta (WhatsApp); ele precisa de um Gateway de Envio.
A instituição deve contratar ou desenvolver esse serviço de mensageria. Existem três modelos principais de integração disponíveis no mercado, variando em custo, estabilidade e complexidade técnica.
Atenção:
Verifique junto à sua instituição, se já utilizam envio de mensagens por whatsapp. Neste caso, bastaria utilizar todo o mecanismo já existente.
3. Alternativas de Mercado para o Gateway de Envio
Abaixo estão listadas as três arquiteturas possíveis para conectar o BNWEB ao WhatsApp, cabendo à instituição escolher a que melhor se adapta ao seu orçamento e política de TI.
Opção A: API Oficial (Meta/BSPs) – Recomendado para Alta Estabilidade
Utiliza a infraestrutura oficial do WhatsApp Business API. Geralmente contratada através de parceiros (BSPs) como Twilio, Gupshup ou Zenvia.
Como funciona: O BNWEB envia os dados para o provedor oficial, que entrega a mensagem com garantia de segurança.
Vantagens: Risco zero de bloqueio do número; alta estabilidade (SLA 99.9%); não depende de celular físico ligado.
Desvantagens: Custo variável por mensagem enviada (modelo de “janelas de conversação” cobrado pelo Facebook); exige aprovação de templates de mensagem.
Custo Estimado: Taxa fixa da ferramenta + Custo por mensagem – verificar valores atualizados..
Opção B: Gateways SaaS (APIs Intermediárias) – Custo-Benefício
Empresas que fornecem um serviço que simula o WhatsApp Web em nuvem. Exemplos: Z-API, PlugMessage, MegaAPI.
Como funciona: A biblioteca contrata o serviço, escaneia um QR Code com um celular da instituição e o serviço fornece uma URL de API para configurar no BNWEB.
Vantagens: Custo fixo mensal (envios ilimitados); implementação rápida; permite envio de qualquer texto sem aprovação prévia.
Desvantagens: Depende da conexão do celular da biblioteca (se o celular ficar sem bateria ou internet, o envio falha); risco moderado de banimento se houver abuso (spam).
Custo Estimado: Mensalidade fixa – verificar valores atualizados.
Opção C: Solução Própria (Open Source) – Para Equipes de TI
A instituição hospeda sua própria API utilizando bibliotecas de código aberto (como Evolution API ou Baileys) em seus próprios servidores.
Como funciona: A TI da instituição sobe um servidor (Docker/Node.js), conecta o WhatsApp da biblioteca e cria o endpoint para o BNWEB consumir.
Vantagens: Sem custo de licença de software; controle total dos dados.
Desvantagens: Exige conhecimento técnico avançado para instalação e manutenção; se o WhatsApp atualizar, a API pode parar de funcionar até que a TI atualize o sistema.
Custo Estimado: Apenas o custo de infraestrutura (Servidor/VPS).
4. Quadro Comparativo Resumido
| Característica | API Oficial (Meta/Twilio) | Gateway SaaS (Z-API/Outros) | Solução Própria (Self-Hosted) |
| Custo BNWEB | Gratuito | Gratuito | Gratuito |
| Custo do Envio | Variável (por mensagem) | Fixo (mensalidade) | Infraestrutura apenas |
| Dependência de Celular | Não (Nuvem) | Sim (QR Code) | Sim (QR Code) |
| Complexidade Técnica | Média | Baixa | Alta |
| Risco de Bloqueio | Nulo | Baixo (se moderado) | Baixo (se moderado) |
5. Requisitos para Implantação
Para ativar a integração, a equipe responsável pelo BNWEB precisará das seguintes informações fornecidas pela solução escolhida:
- Endpoint (URL) da API: O endereço para onde o BNWEB enviará os dados.
- Token de Autenticação: A chave de segurança para validar o envio.
- Documentação dos Parâmetros: (Ex: como a API espera receber o número de telefone e a mensagem).