API de WhatsApp, cobrada por instância

A API de WhatsApp que não para de falar.

Conecte um número, leia o QR e mande mensagem pela API. Os eventos chegam no seu webhook, assinados.

# manda uma mensagem pela instância
# API=https://api.maritacaapi.com.br

curl -X POST $API/instancias/$ID/token/$TOKEN/enviar-texto \
  -H "Client-Token: $CLIENT_TOKEN" \
  -d '{"telefone": "5511999990000",
       "mensagem": "Seu pedido saiu pra entrega."}'

# no seu webhook, logo depois
{ "tipo": "mensagem.enviada", "sequencia": 42 }

Feita pra quem integra, não pra quem só testa.

Uma instância por número

Cada número conectado é uma instância, com token próprio.

Webhook assinado

Cada entrega vai assinada com HMAC e com um id para você descartar duplicatas.

Sessão salva

Se o servidor reiniciar, o número volta conectado sem pedir QR de novo.

Fila anti-bloqueio

Os envios de cada número saem com intervalo, num ritmo parecido com o de uma pessoa.

Reentrega automática

Seu servidor não respondeu? A Mari tenta de novo.

30 s

2 min

10 min

30 min

1 h

3 h

6 h

Três passos e o número tá falando.

Crie a instância

Uma chamada com o token da conta. Volta o id e o token da instância.

POST /conta/instancias
Client-Token: $CLIENT_TOKEN

Pareie o número

Leia o QR em Aparelhos conectados no WhatsApp, ou use um código de pareamento.

→ qr.atualizado
→ instancia.pareada
→ instancia.conectada

Mande e receba

Envie texto, imagem, áudio ou documento pela API. Respostas e status chegam no seu webhook.

POST /instancias/{id}/token/{token}/enviar-texto
→ mensagem.enviada
→ mensagem.status

O que chega no seu webhook

qr.atualizado instancia.pareada instancia.conectada instancia.reconectando instancia.desconectada mensagem.recebida mensagem.enviada mensagem.status mensagem.falhou

Preço

Fale com a gente

Cada número conectado é uma instância, cobrada por mês. Conta quantos números você vai conectar que a gente passa o valor.

Token próprio por instância
Webhook com HMAC e id contra duplicatas
Reentrega de 30 s até 6 h
Sessão salva entre reinícios
Fila anti-bloqueio por número

Falar no WhatsApp

Antes de contratar

A Maritaca é uma integração não oficial com o WhatsApp. Use números dedicados: o número conectado pode ser bloqueado.