Documentação da API

Guia de Integração

Bem-vindo à API da TechInteligente. Integre o envio de mensagens de WhatsApp ao seu sistema de forma rápida e segura. Nossa API é baseada em requisições REST utilizando o protocolo HTTP POST.

Autenticação

Inclua seu Bearer Token no cabeçalho Authorization ou via parâmetro api_key.

Authorization: Bearer sua_chave_api_aqui

Fluxo de Envio

O envio é **assíncrono**. Ao postar uma mensagem:

  • A API responde imediatamente com queued e um log_id.
  • Nossa fila processa e tenta a entrega via WhatsApp.
  • Você pode consultar o status final (`sent` ou `failed`) no endpoint de **Logs**.
POST

Enviar Mensagem

https://mensagens.techinteligente.site/api/v1/send
Parâmetros (JSON)
Campo Tipo Descrição
to String Número com DDD (ex: 45999998888)
message Text Conteúdo da mensagem (UTF-8)
media URL Opcional. Link direto para imagem (JPG/PNG) ou PDF.
Exemplo cURL
curl -X POST "https://mensagens.techinteligente.site/api/v1/send" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "45920014605",
    "message": "Olá! Sua reserva foi confirmada. ✅",
    "media": "https://meusite.com/voucher.pdf"
  }'
GET

Obter QR Code

Retorna a imagem PNG do QR Code para conexão da sua instância. Útil para embutir o pareamento diretamente no seu sistema.

https://mensagens.techinteligente.site/api/v1/qrcode 
<!-- Exemplo de uso em HTML -->
<img src="https://mensagens.techinteligente.site/api/v1/qrcode?api_key=YOUR_API_KEY" alt="Conectar WhatsApp" />

<!-- Nota: O middleware também aceita api_key via query string para facilitar o uso em tags <img> -->
GET

Status da Conexão

Verifica se o seu WhatsApp está conectado e pronto para enviar mensagens.

https://mensagens.techinteligente.site/api/v1/status 
curl -X GET "https://mensagens.techinteligente.site/api/v1/status" \
  -H "Authorization: Bearer YOUR_API_KEY"
GET

Logs de Mensagens

Retorna o histórico de mensagens enviadas e seus respectivos status.

https://mensagens.techinteligente.site/api/v1/logs 
curl -X GET "https://mensagens.techinteligente.site/api/v1/logs" \
  -H "Authorization: Bearer YOUR_API_KEY"
Horário Comercial

Mensagens enviadas fora do horário comercial (08h-18h) serão rejeitadas caso a configuração de "Horário Comercial" esteja ativa no seu painel.

Limite de Plano

Você receberá um erro 403 Forbidden caso atinja o limite de mensagens mensal ou tente enviar mídia em um plano não suportado.

Webhook de Status

O sistema envia notificações automáticas via WhatsApp se houver falhas críticas na entrega, mantendo você informado sobre sua saúde de disparo.