BetaUsar webhooks em agentes

Use ações de webhook em agentes para enviar e receber dados de sistemas externos. Você pode configurar ações de webhook no construtor do agente para fazer solicitações HTTP (por exemplo, GET ou POST), para disparar processos externos ou recuperar dados.

As ações de webhook ajudam a conectar agentes a ferramentas externas sem exigir integrações personalizadas. Por exemplo, você pode enviar dados de negócios para um sistema externo para acionar o atendimento, ou recuperar informações do cliente de outra plataforma e usá-las na saída do seu agente.

Observação: você pode gerenciar o acesso aos recursos de IA nas suas configurações de IA e configurar quais dados são compartilhados. Consulte as Perguntas frequentes sobre a confiança na IA e os Cartões de modelo de IA da HubSpot para obter informações detalhadas sobre controles de segurança de IA, uso de dados e conformidade.

Antes de começar

Antes de começar a usar webhooks em agentes, revise os requisitos e considerações.

• Um superadministrador deve ativar as seguintes opções nas Configurações de IA:

  • Ofereça aos usuários acesso a ferramentas e recursos de IA generativa

  • Dados do CRM

  • Dados de conversação do cliente

  • Dados dos arquivos

  • Conceder aos usuários acesso ao Breeze Assistant

Adicionar uma ação de webhook a um agente

Adicione uma ação de webhook no construtor de agentes para enviar ou recuperar dados de um sistema externo. Use o menu suspenso Método para selecionar como o agente deve se comunicar com o URL do webhook:

• GET: recupera valores de outro sistema. Use solicitações GET quando o agente precisar fazer referência a informações de um sistema externo posteriormente na execução do agente, como um status de assinatura, status do pedido ou campo de perfil do cliente.

• POST: enviar valores para outro sistema. Use solicitações POST quando o agente precisar gatilho ou atualizar algo fora do HubSpot, como criar uma solicitação de atendimento, enviar uma notificação ou atualizar um registro externo.

Para adicionar uma ação de webhook:

1. Na sua conta da HubSpot, clique em Mais e navegue até o Hub do Agente para Agentes >. Se Mais não aparecer na sua conta, navegue diretamente para o Agents > Agent Hub .

2. Clique na guia Agentes.

3. Clique em Editar no cartão de um agente existente ou crie um novo agente.

4. No construtor do agente, clique em Adicionar ação na seção Ações .

5. No painel direito, insira Enviar um webhook no campo Pesquisar . Em seguida, clique na ação Enviar um webhook.

6. Clique no menu suspenso Método e selecione o tipo de solicitação (por exemplo, POST ou GET).

7. No campo URL do Webhook , insira a URL para a qual a solicitação deve ser enviada.

8. Clique no menu suspenso Tipo de autenticação e selecione um tipo de autenticação.

9. Dependendo do método selecionado (por exemplo, GET ou POST), configure os valores a serem incluídos na solicitação.

   • Para solicitações GET , na seção Parâmetros de consulta, clique em Adicionar valor estático para adicionar os nomes e valores a serem anexados à URL do webhook.

   • Para solicitações POST , na seção Corpo da solicitação, clique em Adicionar valor estático para adicionar valores a serem incluídos no corpo de solicitação do webhook.

10. Para testar a ação do webhook, clique em Testar. Revise a resposta para confirmar se a solicitação está configurada corretamente. Se o teste falhar, revise o URL do webhook, o método, o tipo de autenticação, os parâmetros de consulta ou o corpo da solicitação e teste a ação novamente.

11. Quando terminar, clique em Salvar e adicionar.
12. Continue a personalizar o agente e publique.

Próximas etapas

• Criar e personalizar agentes no construtor de agentes
• Executar agentes e revisar a saída na caixa de entrada do agente
• Revisar custos estimados de crédito ao usar agentes