O que são webhooks?
Os Webhooks no RemOnline permitem que os seus sistemas recebam atualizações em tempo real quando ocorrem determinados eventos. As atualizações são enviadas como ordenes HTTP POST para o seu endpoint especificado, permitindo-lhe automatizar processos e integrar-se com outras aplicações.
Qual é a diferença entre APIs e Webhooks?
Parâmetro | API | Webhooks |
Como funciona | O utilizador faz um pedido à API e recebe uma resposta. | O sistema envia automaticamente dados para o seu endpoint quando ocorre um evento. |
Iniciador da interação | A sua aplicação inicia um pedido (por exemplo, para obter uma lista de ordens). | O RemOnline inicia o envio dos dados para o seu servidor. |
Frequência de utilização | É necessário efetuar pedidos periodicamente, mesmo que não haja alterações (Polling). | Os dados são enviados apenas quando algo acontece (Event-driven). |
Recursos do servidor | Depende da frequência dos pedidos - pedidos frequentes podem sobrecarregar o servidor. | Utiliza menos recursos porque os pedidos são efectuados apenas quando ocorrem eventos. |
Exemplos de utilização | Recuperação de informações sobre ordens, clientes, tarefas, etc., a pedido. | Recebíveis notificações em tempo real quando o status de uma ordem muda, uma tarefa é criada ou uma nova revisão de cliente é recebida. |
Atraso nas atualizações | Pode haver um atraso devido à necessidade de pedidos periódicos manuais ou automáticos. | A atualização é enviada instantaneamente após a ocorrência do evento. |
Complexidade de configuração | Requer o desenvolvimento e a integração de pedidos (GET, POST, PUT, DELETE, etc.). | Só precisa de especificar o destino e selecionar os eventos em que está interessado. |
💡 Para simplificar:
A API é como uma loja que você vai para obter as informações de que precisa. O utilizador decide quando ir e pede o que precisa. Utilize uma API se precisar de solicitar dados ou executar ações a ordem.
Os Webhooks são como uma entrega ao domicílio. Não tem de ir a lado nenhum; os dados são-lhe entregues automaticamente assim que estiverem disponíveis. Utilize webhooks se pretender receber automaticamente atualizações em tempo real sem ter de as solicitar constantemente.
Como os webhooks funcionam?
Ocorre um evento: É acionado um evento específico no sistema, como a criação de uma ordem ou uma atualização de status.
Envio de dados: O sistema envia um pedido HTTP POST com os detalhes do evento em formato JSON para o seu ponto de extremidade.
Processamento de dados: O seu sistema processa os dados recebidos para outras ações ou integrações.
Configurações de webhooks
1. Inicie sessão na sua conta.
2. Aceda a Configurações > API.
3. Clique em + Webhook e introduza as seguintes informações:
URL de destino: O URL para o qual os dados do evento serão enviados.
Descrição: Uma breve descrição do webhook.
Eventos: Selecionar os eventos para os quais pretende receber atualizações.
4. Clique em Criar.
Importante: Certifique-se de que o seu ponto final está acessível e utiliza HTTPS para uma transferência de dados segura.
Pode criar um máximo de 5 webhooks por conta para garantir a eficiência do sistema.
Todos os pormenores podem ser encontrados nesta página.
Eventos suportados
Os webhooks suportam várias categorias de eventos, incluindo tarefas, ordenes, ordens, clientes e facturas.
Para obter uma lista completa de eventos, consulte Configurações > API > Webhooks na nova janela de criação de webhook ou esta documentação.
Como posso utilizar os webhooks?
Tendo acesso direto às APIs de outros serviços ou utilizando conectores online como Zapier ou Make.com, pode criar um endpoint e especificar o seu URL para um webhook, para o qual o RemOnline enviará automaticamente notificações sobre o evento selecionado.
Desta forma, pode automatizar muitos processos:
Envio de notificações por SMS:
Utilizar serviços de SMS de terceiros para informar os clientes sobre alterações no status da ordem, data de disponibilidade ou mudança de gestor.
Integração com o Google Sheets:
Adicionar automaticamente novos dados de ordens ou tarefas ao Google Tarefas para efeitos de análise ou relatórios.
Automatização de lembretes:
Enviar lembretes a clientes ou funcionários através do canal selecionado (e-mail, mensageiros, notificações push) sobre prazos de ordem ou expiração de tarefas.
Relatórios em tempo real:
Atualizar painéis (por exemplo, em Power BI ou Tableau) quando são criadas ou alteradas ordens, tarefas, faturas, etc.
Integração com programas de contabilidade:
Transferência automática de dados sobre faturas criadas e alterações nos pagamentos para programas de contabilidade (por exemplo, 1C, QuickBooks).
Notificações de eliminação de dados:
Notificar os gerentes ou tomadores de decisão quando clientes, ordens, faturas ou tarefas são eliminados para acompanhar as alterações no sistema.
Estes exemplos demonstram como os webhooks podem automatizar processos empresariais, integrar-se em várias plataformas e melhorar a comunicação. No entanto, as possibilidades de os utilizar são quase infinitas - tudo depende das suas necessidades e criatividade!