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.

Criar conta Ver os 3 passos
Mari, a maritaca, de bico aberto falando
# manda uma mensagem pela instância
# API=https://api.maritacaapi.com.br
curl -X POST $API/Instancias/Mensagens/Texto \
  -H "Client-Token: $CLIENT_TOKEN" \
  -H "Instancia-Id: $ID" -H "Instancia-Token: $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.

01

Uma instância por número

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

02

Webhook assinado

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

03

Sessão salva

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

04

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.

1

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
2

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
3

Mande e receba

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

POST /Instancias/Mensagens/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
Só R$95 por número,
por mês.
Mari, a maritaca, anunciando o preço
Dá uns R$ 3,17 por dia. Sem cobrança por mensagem enviada.

Tudo incluso no mesmo valor

Cada número conectado é uma instância. Tudo o que a API faz está incluso, sem cobrança por mensagem. Paga por PIX ou cartão, e a primeira fatura só sai quando você cria a primeira instância.

  • 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
Criar conta ou fale no WhatsApp

Perguntas que a Mari mais ouve.

Quanto custa a Maritaca?

R$ 95 por mês para cada número conectado (cada número é uma instância). Tudo o que a API faz está incluso, sem cobrança por mensagem.

Quando sai a primeira fatura?

Só quando você cria a primeira instância. Dá para pagar por PIX ou cartão.

Como conecto um número de WhatsApp?

Crie a instância com uma chamada à API usando o token da conta. Depois leia o QR em Aparelhos conectados, no WhatsApp do celular, ou use um código de pareamento.

Que tipos de mensagem dá para enviar?

Texto, imagem, áudio e documento, todos pela API, com o token da instância.

Como recebo as respostas e os status das mensagens?

Pelo seu webhook. Cada entrega vai assinada com HMAC e leva um id para você descartar duplicatas. Chegam eventos de QR, pareamento, conexão, mensagem recebida, enviada, status e falha.

E se o meu servidor estiver fora do ar?

A Maritaca tenta entregar o evento de novo: depois de 30 s, 2 min, 10 min, 30 min, 1 h, 3 h e 6 h.

Se o servidor reiniciar, preciso ler o QR de novo?

Não. A sessão fica salva e o número volta conectado sozinho.