Para Desenvolvedores

SDK e API
Documentação.

Instale nosso SDK de 4kb no seu front-end em 2 minutos. Nossa plataforma resolve tokens de service workers e telemetria silenciosamente.

1. Instalação do SDK

O ArautoFlow é ativado incluindo nosso script principal na tag <head> do seu projeto web. Ele deve estar presente em todas as páginas onde deseja rastrear os usuários e pedir permissão de push.

index.html
<!DOCTYPE html>
<html>
<head>
<title>Meu App</title>
/* Importe o ArautoFlow SDK */
<script src="https://arautoflow.com.br/sdk/arautoflow.js"></script>
</head>

2. Inicialização (App Key)

Após importar o SDK, inicialize-o com a sua APP_KEY única, fornecida no painel do cliente. Isso vinculará automaticamente o domínio atual ao seu Workspace.

app.js
document.addEventListener("DOMContentLoaded", function() {
// Inicializa o motor de tracking e push
ArautoFlow.init('SUA_APP_KEY_AQUI');
});

3. Rastreio de Eventos (Opcional)

Você pode enviar métricas comportamentais (como compras ou abandono de carrinho) para alimentar as Automações Procedurais diretamente pelo SDK.

checkout.js
// Dispara quando o usuário clica em "Adicionar ao Carrinho"
function onAddToCart(product) {
ArautoFlow.trackEvent('add_to_cart', {
item_id: product.id,
value: product.price
});
}

4. Mobile Nativo (API Universal)

Como nossa infraestrutura é API-First, você não precisa instalar bibliotecas pesadas se o seu aplicativo for nativo. Basta usar a SDK oficial do Firebase para gerar o token e enviá-lo para nossa API.

Atenção Crítica para Apple (iOS)

Diferente do Android, a Apple possui políticas de privacidade extremamente rígidas. O token do Firebase só será gerado ou terá utilidade se o usuário clicar expressamente em "Permitir" no popup do sistema (UNUserNotificationCenter).

  • Se o usuário negar a permissão, a função falhará silenciosamente.
  • Sugerimos fortemente o uso de "Pré-Permissões" (telas de onboarding explicando o valor das notificações) antes de disparar o popup nativo.
  • É obrigatório possuir uma conta Apple Developer e enviar a chave APNs (.p8) no Firebase Console.
react-native.js
// Exemplo rápido para React Native / Expo
const token = await messaging().getToken();
await fetch('https://arautoflow.com.br/api/register-device', {
method: 'POST',
headers: {
'Authorization': 'Bearer SUA_APP_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
device_uid: uniqueId,
platform: 'ios', // ou 'android'
token: token
})
});
Acesse o painel para códigos Kotlin e Swift

Ainda tem dúvidas técnicas?

Nossa infraestrutura foi projetada por devs, para devs. Se precisar de endpoints avançados ou integração backend-to-backend, fale com nosso suporte ou acesse o painel.

Acessar Portal do Cliente