Para software houses, ERPs e integradores
Mande o boleto pelo WhatsApp do seu cliente, direto do seu sistema.
O Rogoy Connect é uma API REST que conecta o número de WhatsApp de cada cliente seu ao sistema que você já vende. O cliente lê um QR Code, e a partir daí o seu software envia lembretes, boletos, notas e confirmações com uma requisição HTTP.
Pedir acesso de teste Já sou cliente: entrar Ver como integrar
- Protocolo
- HTTPS + JSON
- Autenticação
- Token por cliente
- Conexão
- QR Code, número do próprio cliente
- Envio
- Texto, PDF, imagem, vídeo, áudio
- Retorno
- Webhook por cliente
- Linguagens
- Qualquer uma que faça POST
Olá, Maria. Seu boleto de R$ 189,90 vence amanhã.
PDF boleto-1042.pdf
Obrigada! Já paguei.
POST /api/mensagens/arquivo
O que a API faz
-
Conecta por QR Code
Um endpoint devolve a imagem do QR Code. Você mostra na sua tela; o cliente lê com o celular e continua usando o WhatsApp normalmente.
-
Separa cada cliente
Cada cliente seu tem token e instância próprios. Um não acessa o número do outro, e você bloqueia qualquer um sem afetar os demais.
-
Envia arquivos
Boletos, notas fiscais, comprovantes, fotos de produto. Por URL ou base64, com legenda.
-
Avisa o seu sistema
Mensagens recebidas e quedas de conexão chegam por webhook na URL que você cadastrar para cada cliente.
-
Conta o consumo
Limite mensal por cliente e histórico de cada envio, com status e erro. Tudo visível no portal, base pronta para você cobrar.
-
Roda no seu servidor ou no nosso
Hospedamos para você, ou instalamos em um servidor seu (Windows ou Linux) com a sua marca.
Integração
Três chamadas cobrem o fluxo inteiro:
- Conectar.
POST /api/whatsapp/conectardevolve o QR Code em base64. - Conferir.
GET /api/whatsapp/statusresponde"open"quando o número está conectado. - Enviar.
POST /api/mensagens/textoou/arquivo, com o número e o conteúdo.
Sem SDK obrigatório. Funciona em C#, Delphi, VB, Java, PHP, Python e Node.
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-Api-Key", "rc_9f2c...");
var resp = await http.PostAsJsonAsync(
"https://rogoyconnect.com.br/ApiRogoyConnect/api/mensagens/arquivo",
new {
numero = "5511999999999",
arquivo = "https://meusistema.com/boletos/1042.pdf",
tipo = "document",
nomeArquivo = "boleto-1042.pdf",
legenda = "Seu boleto vence amanhã."
});
var
Http: TNetHTTPClient;
Body: TStringStream;
begin
Http := TNetHTTPClient.Create(nil);
Body := TStringStream.Create(
'{"numero":"5511999999999","texto":"Pedido 1042 saiu para entrega."}',
TEncoding.UTF8);
try
Http.CustomHeaders['X-Api-Key'] := 'rc_9f2c...';
Http.ContentType := 'application/json';
Http.Post('https://rogoyconnect.com.br/ApiRogoyConnect/api/mensagens/texto', Body);
finally
Body.Free; Http.Free;
end;
end;
$ch = curl_init("https://rogoyconnect.com.br/ApiRogoyConnect/api/mensagens/texto");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["X-Api-Key: rc_9f2c...", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode([
"numero" => "5511999999999",
"texto" => "Sua consulta é amanhã às 14h."
])
]);
echo curl_exec($ch);
curl -X POST https://rogoyconnect.com.br/ApiRogoyConnect/api/whatsapp/conectar \
-H "X-Api-Key: rc_9f2c..."
{
"estado": "connecting",
"qrCode": "data:image/png;base64,iVBORw0KGgo..."
}
Planos
Cobrança por número de WhatsApp conectado. Sem taxa por mensagem dentro do limite.
Valores de exemplo. Ajuste para a sua tabela.
Perguntas
O cliente precisa de um número novo?
Não. Ele usa o número que já tem. A conexão funciona como o WhatsApp Web: o celular continua funcionando normalmente.
É a API oficial do WhatsApp?
Não. A conexão padrão usa o protocolo do WhatsApp Web, que é mais simples e barato, mas não é oficial. Disparos em massa para quem não tem o número salvo podem levar a bloqueio. Para volumes grandes, avaliamos com você o uso da API oficial (WhatsApp Cloud API).
Como meu cliente conecta o WhatsApp e pega a senha de integração?
Cada cliente recebe um acesso ao portal do Rogoy Connect. Lá ele lê o QR Code, vê e troca a senha de integração, cadastra o webhook, acompanha o consumo do mês e envia mensagens de teste.
Funciona com sistemas antigos, em Delphi ou VB?
Sim. Basta o sistema conseguir fazer uma requisição HTTP com JSON.
Como recebo as respostas dos clientes finais?
Cadastre uma URL de webhook para cada cliente. A cada mensagem recebida ou mudança de conexão, o Rogoy Connect faz um POST nessa URL.
Dá para testar antes de contratar?
Sim. Liberamos um token de teste para você integrar e validar o fluxo completo com um número seu.
Peça um token de teste.
Respondemos em até um dia útil com o acesso e a documentação.