Chatbots com IA e automaçãoAutomações
ChatCase DocsChatCase DocsUma automação webhook atua como um ponto de entrada em um fluxo ChatCase, recebendo uma solicitação HTTP, processando-a através da lógica de fluxo, e opcionalmente retornando uma r
Uma automação webhook atua como um ponto de entrada** em um fluxo ChatCase, recebendo uma solicitação HTTP, processando-a através da lógica de fluxo, e opcionalmente retornando uma resposta HTTP estruturada.
Ir em Fluxos > Automations anche escolha "Webhook"
Cada URL está ligada ao mesmo fluxo de automação, mas serve um propósito diferente.
O webhook de desenvolvimento** foi projetado para testes e depuração.
Principais características:
Isso o torna ideal para:
O webhook de produção** é destinado a ambientes vivos.
Características:
Uma vez que sua automação é testada através do webhook de desenvolvimento, você pode mudar com segurança os clientes para a URL de produção.
Todos os dados enviados para o pedido webhook é automaticamente disponibilizado dentro do fluxo através do payload objeto.
Exemplo
Se um sistema externo enviar o seguinte corpo JSON:
{
"name": "Andrea",
"email": "redacted@example.invalid"
}
`$([Environment]::NewLine)
Você pode acessar esses valores em qualquer lugar do fluxo usando:
*`payload.name`
* `payload.email`No exemplo a seguir estamos ecoando o nome fornecido na carga útil pós na chamada
<figure><img src="/doc-images/ZCkOFuZ7Gcri61BcvJ70.png" alt=""><figcaption></figcaption></figure># # Retornando uma resposta
Para retornar uma resposta ao cliente chamado, você deve usar explicitamente a ação **Response** dentro do fluxo.
ação de Resposta
A ação **Response** permite definir:
* Código de estado HTTP (por exemplo.`200`, `201`, `400`, `500`)
* Corpo de resposta JSON
# # Fogo-e-Esquecer Webhooks
Se ** nenhuma ação de resposta** estiver presente no fluxo:
* O webhook comporta-se como ** fogo-e-esquecer
* ChatCase retorna imediatamente uma resposta padrão ao chamador
* A automação continua executando assíncrona em segundo plano
Este modo é útil quando:
* O chamador não precisa de uma resposta
* Você está disparando processos de longo prazo ou de fundo
* Você quer responsividade máxima no lado do cliente
## # Webhook Logs & Administração
ChatCase fornece uma seção dedicada **Webhook Administration** no painel.
<figure><img src="/doc-images/gYIfZnOcIgdv2QqunPHv.png" alt=""><figcaption></figcaption></figure>A partir deste painel você pode:
* Monitor **runtime webhook logs**
* Inspecione cargas úteis de solicitação e resultados de execução
* Temporariamente **desativar um webhook** se necessário (por exemplo, por razões de manutenção ou segurança)
<figure><img src="/doc-images/Aa53B8iBaeOH7MOCkMHx.png" alt=""><figcaption></figcaption></figure>Este componente é especialmente útil em ambientes de produção para garantir a observação e o controle operacional.
Casos de uso típicos
Automaçãos Webhook são ideais para:
* Integrando sistemas externos (CRM, ERP, serviços de infraestrutura)
* Acionando fluxos de trabalho de plataformas de terceiros
* Recebendo eventos de aplicativos personalizados
* Construindo automações de servidor para servidor
* Implementação de processamento de fundo assíncrono
Resumo do Webhook ChatCase
* Automaçãos Webhooks expõem fluxos de ChatCase como endpoints HTTP
* Duas URLs estão disponíveis: **Desenvolvimento** (com depuração em tempo real) e **Produção**
* Os dados da solicitação de entrada são acessíveis através do`payload`objeto
* Use a ação **Response** para retornar respostas HTTP personalizadas
* Sem uma ação de resposta, o webhook é executado no modo **fire-and-forget**
* O painel fornece monitoramento completo e controle administrativo
Isso faz do ChatCase Webhooks uma base poderosa e flexível para automação orientada a eventos e integração do sistema.