API e webhooks: conecte seu ERP, seu site, Zapier ou Make com a Remotjob
Cada organização cria suas próprias chaves de API com permissões por recurso, lê e carrega dados dos seus outros sistemas e recebe avisos assinados quando algo acontece: um pedido, uma fatura emitida, um pagamento, um lead ou estoque abaixo do mínimo. Sem que ninguém precise copiar dados à mão.
Seus sistemas não deveriam depender de alguém copiar e colar
Quando seu ERP, seu site ou suas planilhas vivem separados da Remotjob, alguém acaba passando clientes, pedidos e faturas de um para o outro, e ninguém fica sabendo a tempo de que algo mudou. Com a API e os webhooks, seus sistemas leem e carregam o que precisam, e a Remotjob avisa no momento em que acontece.
Da chave ao aviso, em seis passos
Tudo é administrado em uma única tela, sem escrever uma linha de código até você querer.
1
Crie uma chave de API
Você dá um nome e marca, recurso por recurso, o que ela pode ler e o que pode criar. Se quiser, limita os endereços IP de onde ela é usada, define uma data de validade e um limite de chamadas por minuto.
2
Guarde-a: ela é exibida uma única vez
O segredo aparece uma só vez, com botão para copiar; a Remotjob guarda apenas uma impressão digital e não pode mostrá-lo de novo. Se for perdido, você gira a chave e a anterior deixa de funcionar.
3
Conecte seu sistema
Seu ERP, seu site ou sua automação chama a API com a chave: lê clientes, produtos, faturas emitidas e estoque, e cria clientes, pedidos em rascunho e leads. A documentação OpenAPI traz exemplos prontos para copiar.
4
Escolha os avisos que quer receber
Você informa um endereço https e os eventos de seu interesse: pedido criado, fatura emitida, pagamento recebido, lead criado ou estoque abaixo do mínimo. Dá para enviar um evento de teste antes de depender dele.
5
Cada aviso chega assinado
A Remotjob assina cada envio para que seu sistema confirme que veio da plataforma e não foi alterado. Se seu sistema não responder, ela tenta de novo com esperas crescentes e guarda o registro de cada entrega.
6
Revise, reenvie e controle
Você vê as chamadas e as entregas com seu detalhe, reenvia à mão a que falhou e, se um endereço falhar muitas vezes seguidas, a assinatura se pausa sozinha e avisa por e-mail.
O que inclui
Chaves por organização, com permissões por recurso
Cada chave pode ler ou criar apenas o que você atribuir: clientes, produtos, pedidos, faturas emitidas, leads ou estoque. São criadas, editadas, giradas e revogadas na tela.
IPs permitidos, validade e limite por minuto
Uma chave pode ser usada só dos endereços IP que você indicar, vencer em uma data e ter seu próprio limite de chamadas por minuto, para que um erro de um sistema externo não sobrecarregue o seu.
Leitura e carga de dados do negócio
Você lê clientes, produtos, faturas emitidas e estoque; cria clientes, pedidos e leads. Os pedidos entram como rascunho: alguém da sua equipe os confirma na Loja.
Webhooks assinados
Avisos de pedido criado e confirmado, fatura emitida e paga, pagamento recebido, lead criado e estoque abaixo do mínimo, com assinatura verificável e sem dados pessoais no aviso: traz identificadores e valores; o detalhe você consulta pela API.
Novas tentativas e registro de entregas
Se seu sistema falhar, a Remotjob tenta de novo com esperas cada vez maiores e registra cada tentativa com o que enviou e o que seu sistema respondeu. Você pode reenviar à mão.
Registro de chamadas
Cada chamada à API fica registrada com método, rota, resultado e duração, sem guardar o conteúdo enviado, para você entender o que cada chave faz.
Documentação OpenAPI com exemplos
Contrato OpenAPI para baixar e exemplos em curl, JavaScript e Python, além de como verificar a assinatura de um webhook, dentro da própria tela.
Guia para Zapier e Make
Para conectar ferramentas sem programar, usam-se os módulos genéricos de webhook e HTTP do Zapier e do Make com a sua chave. A Remotjob não publica um aplicativo próprio no Zapier.
Integrar sem abrir a porta além do necessário
Uma integração é uma porta para os seus dados. Aqui cada chave se limita ao que precisa e cada uso fica registrado.
Cada chave vê apenas os dados da sua própria organização; pedir um dado de outra organização responde como se ele não existisse.
Os segredos não podem ser lidos de novo: a chave é exibida uma única vez e o segredo do webhook só é visto por quem tem permissão de administrar.
Criar e girar chaves exige ser membro direto da organização com permissão de administração; se essa pessoa sair da organização, a chave dela deixa de funcionar.
Os webhooks só vão para endereços https públicos: destinos internos ou privados são bloqueados, e os avisos não levam nomes, e-mails nem telefones.
O que é e o que não é
Os pedidos criados pela API ficam em rascunho: não são confirmados sozinhos, uma pessoa da equipe os confirma.
A API entrega as faturas que a sua organização emite; nunca custos, margens nem dados de cobrança de terceiros.
Zapier e Make se conectam pelos seus módulos de webhook e HTTP; não existe um aplicativo próprio da Remotjob publicado no Zapier.
Está incluída na assinatura e não consome créditos de IA.
Vídeo · 1 min 4 s
API e webhooks, explicado em vídeo
Link copiado
Link copiado
Narração em português com legendas em inglês.
Como se usa
Aprenda a usar em minutos
Link copiado
Link copiado
Chaves e webhooks: seus sistemas conectados · 25s
Perguntas frequentes
Quanto custa usar a API e os webhooks?
Estão incluídos na assinatura da Remotjob e não consomem créditos de IA.
O que posso ler e criar com a API?
Você pode ler clientes, produtos, pedidos, faturas emitidas, leads e estoque, e criar clientes, pedidos em rascunho e leads. Cada chave só pode fazer o que você autorizou.
E se eu perder o segredo de uma chave?
O segredo é exibido uma única vez e não pode ser recuperado. Você gira a chave na tela, recebe um segredo novo e a chave anterior deixa de funcionar.
E se meu sistema não receber um aviso?
A Remotjob tenta de novo com esperas cada vez maiores e registra cada tentativa. Você vê o que seu sistema recebeu, reenvia o aviso à mão e, se o endereço falhar muitas vezes seguidas, a assinatura se pausa sozinha e avisa por e-mail.
Como me conecto com Zapier ou Make?
Você usa o módulo de webhook ou HTTP de cada ferramenta com a sua chave. A tela traz um guia passo a passo; não é preciso programar.
Conecte seus sistemas com a Remotjob
Conte qual sistema você quer conectar e quais dados devem trafegar: mostramos como ficaria com as suas chaves, as suas permissões e os seus avisos.
