Pular para o conteúdo principal

Eventos personalizados

Os Eventos personalizados do MonoChat permitem definir e disparar seus próprios tipos de evento na plataforma, possibilitando automação avançada, integrações e lógica nos seus fluxos de trabalho. Eles são especialmente úteis quando os gatilhos de evento padrão (como "mensagem recebida" ou "formulário enviado") não bastam para capturar seus processos de negócio específicos.

Os eventos personalizados são uma forma poderosa de sinalizar ações, passar dados e conectar diferentes componentes do seu sistema: funções, fluxos, assistentes de IA e serviços externos.

Casos de uso​

Disparo avançado de fluxos de trabalho​

Dispare fluxos ou funções com base em eventos específicos do seu negócio, como:

  • lead_qualified
  • invoice_overdue
  • shipment_delivered
  • support_escalated
  • payment_processed
  • task_assigned

Comunicação entre sistemas​

Emita eventos personalizados a partir de sistemas externos (por exemplo, ERP, CRM, plataformas de e-commerce) para atualizar o MonoChat ou vice-versa:

  • Notifique o MonoChat quando um cliente fizer um pagamento.
  • Dispare webhooks externos quando um evento personalizado for emitido.

Coordenação de assistentes de IA​

Dispare eventos personalizados dentro de assistentes de IA para orquestrar interações complexas:

  • Depois de coletar as informações do usuário, emita user_info_collected para iniciar um fluxo de verificação.
  • Use consent_received para passar à próxima etapa em um bot de várias etapas.

Métricas e monitoramento​

Acompanhe ações específicas emitindo eventos personalizados no seu sistema de logs ou de análise:

  • Conte quantas vezes um usuário conclui uma tarefa.
  • Monitore a frequência de comportamentos específicos dos usuários.

Principais recursos​

Nome do evento e payload​

Cada evento personalizado inclui:

  • Um nome único (por exemplo, user_subscribed, task_completed)
  • Um payload opcional (objeto de dados) que pode ser repassado a sistemas ou fluxos posteriores.

Dispare de qualquer lugar​

Os eventos personalizados podem ser:

  • Disparados manualmente (pela interface)
  • Disparados por programação (a partir de funções, fluxos ou da API)
  • Disparados a partir de webhooks ou aplicativos externos
informação

Para mais detalhes sobre como criar eventos personalizados, consulte nossa página de documentação do SDK!