O que são webhooks?
Os webhooks no Orderry permitem que seus sistemas recebam atualizações em tempo real quando determinados eventos ocorrem. As atualizações são enviadas como solicitações HTTP POST para o ponto de extremidade especificado, o que permite automatizar processos e integrar-se a outros aplicativos.
Qual é a diferença entre APIs e Webhooks?
Parâmetro | API | Webhooks |
Como funciona | Você faz uma solicitação à API e recebe uma resposta. | O sistema envia dados automaticamente para seu endpoint quando ocorre um evento. |
Iniciador da interação | Seu aplicativo inicia uma solicitação (por exemplo, para obter uma lista de ordens). | O Orderry inicia o envio dos dados para o seu servidor. |
Frequência de uso | Você precisa fazer solicitações periodicamente, mesmo que não haja alterações (Polling). | Os dados são enviados somente quando algo acontece (Event-driven). |
Recursos do servidor | Depende da frequência das solicitações - solicitações frequentes podem sobrecarregar o servidor. | Usa menos recursos porque as solicitações são feitas somente quando ocorrem eventos. |
Exemplos de uso | Recuperação de informações sobre ordens, clientes, tarefas etc. sob demanda. | Recebíveis notificações em tempo real quando o status de uma ordem muda, uma tarefa é criada ou uma nova avaliação de cliente é recebida. |
Atraso nas atualizações | Pode haver um atraso devido à necessidade de solicitações periódicas manuais ou automáticas. | A atualização é enviada instantaneamente após a ocorrência do evento. |
Complexidade da configuração | Requer o desenvolvimento e a integração de solicitações (GET, POST, PUT, DELETE, etc.). | Você só precisa especificar o destino e selecionar os eventos nos quais está interessado. |
💡 Para simplificar:
A API é como uma loja à qual você vai para obter as informações de que precisa. Você decide quando ir e solicita o que precisa. Use uma API se precisar solicitar dados ou executar ações sob demanda.
Os webhooks são como uma entrega em domicílio. Você não precisa ir a lugar algum; os dados são automaticamente entregues a você assim que estiverem disponíveis. Use webhooks se quiser receber automaticamente atualizações em tempo real sem precisar solicitá-las constantemente.
Como funcionam os webhooks?
Ocorre um evento: Um evento específico é acionado no sistema, como a criação de uma ordem ou uma atualização de status.
Envio de dados: O sistema envia uma solicitação HTTP POST com os detalhes do evento no formato JSON para seu endpoint.
Processamento de dados: Seu sistema processa os dados recebidos para outras ações ou integrações.
Configurações de webhooks
1. Faça login na sua conta.
2. Vá para Configurações > API.
3. Clique em + Webhook e insira 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: Selecione os eventos para os quais você deseja receber atualizações.
4. Clique em Criar.
Importante: Certifique-se de que seu endpoint esteja acessível e use HTTPS para transferência segura de dados.
Você pode criar no máximo 5 webhooks por conta para garantir a eficiência do sistema.
Todos os detalhes podem ser encontrados nesta página.
Eventos suportados
Os webhooks são compatíveis com várias categorias de eventos, incluindo tarefas, solicitações, ordens, clientes e faturas.
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 usar webhooks?
Tendo acesso direto às APIs de outros serviços ou usando conectores on-line, como Zapier ou Make.com, você pode criar um ponto de extremidade e especificar seu URL para um webhook, para o qual o RemOnline enviará automaticamente notificações sobre o evento selecionado.
Dessa forma, você pode automatizar muitos processos:
Envio de notificações por SMS:
Use serviços de SMS de terceiros para informar os clientes sobre alterações no status da ordem, data de disponibilidade ou mudança de gerente.
Integração com o Google Sheets:
Adicione automaticamente novos dados de ordens ou tarefas ao Google Sheets para fins de análise, ou relatórios.
Automação de lembretes:
Envie lembretes a clientes ou funcionários por meio do canal selecionado (e-mail, mensageiros, notificações push) sobre prazos de ordens ou expiração de tarefas.
Relatórios em tempo real:
Atualize painéis (por exemplo, no Power BI ou Tableau) quando ordens, tarefas, faturas etc. forem criadas ou alteradas.
Integração com programas de contabilidade:
Transferência automática de dados sobre faturas criadas e alterações em pagamentos para programas de contabilidade (por exemplo, 1C, QuickBooks).
Notificações de exclusão de dados:
Notifique os gerentes ou tomadores de decisão quando clientes, ordens, faturas ou tarefas forem excluídos para rastrear as alterações no sistema.
Esses exemplos demonstram como os webhooks podem automatizar processos comerciais, integrar-se a várias plataformas e melhorar a comunicação. No entanto, as possibilidades de uso são quase infinitas - tudo depende de suas necessidades e de sua criatividade!