Personalizar os seus webhooks (BETA)

Se estiver a utilizar webhooks em fluxos de trabalho para enviar pedidos POST ou GET dos seus fluxos de trabalho, pode personalizar os seus webhooks para controlar os dados enviados e recebidos.

Nos seus pedidos POST, pode especificar as propriedades enviadas para quaisquer sistemas externos, como um CRM. Do mesmo modo, nos seus pedidos GET, pode especificar as propriedades pedidas através de parâmetros de consulta. 

Saiba mais sobre webhooks na documentação para desenvolvedores sobre webhooks. Se você tiver dúvidas sobre sua implementação específica de webhooks com o HubSpot, entre em contato com o HubSpot Developers Forums.

Observação: O HubSpot tentará novamente os webhooks com falha por até três dias, começando um minuto após a falha. As falhas subsequentes serão tentadas novamente em intervalos crescentes, com uma lacuna máxima de oito horas entre as tentativas. Saiba sobre as exceções de código de erro específicas na Documentação para desenvolvedores da HubSpot.

Configurar o webhook

Para criar e personalizar os seus webhooks:

• Na sua conta HubSpot, acesse Automações > Fluxos de trabalho.
• Clique no nome do fluxo de trabalho.
• Clique no ícone + para adicionar uma ação.
• No painel direito, selecione Enviar um webhook.
• Clique no menu suspenso Método e selecione POST ou GET. 
• Digite o URL do webhook. As URLs de webhook estão restritas a um protocolo seguro e devem começar com HTTPS. Para solicitar informações específicas, pode adicionar parâmetros de consulta como ?queryparameter=abc ao URL do Webhook . Se nenhum parâmetro de consulta tiver sido adicionado, uma solicitação genérica POST ou GET será enviada. 
• Configure seu tipo de autenticação para autenticar solicitações ao webhook: 
  • Para usar uma assinatura de solicitação no cabeçalho do webhook: 
    • Clique no menu suspenso Tipo de autenticação. Selecione Incluir assinatura de solicitação no cabeçalho.
    • Digite o ID do aplicativo HubSpot. Saiba como verificar assinaturas de pedidos.

• • Também pode utilizar uma chave API para autenticação. Ao utilizar uma chave de API para autenticação, o nome da chave de API e a localização da chave API usada dependerão de como o webhook foi configurado. Por motivos de segurança, a chave de API não será exibida em nenhuma solicitação de teste. Para utilizar uma chave de API: 
    • Clique no menu suspenso Tipo de autenticação. Selecione a chave de API. 

• • • Insira o nome da chave de API.
    • Clique na localização da chave da API menu pendente. Em seguida, selecione Parâmetros de consulta ou Cabeçalho da solicitação. Saiba mais sobre como usar chaves de API no HubSpot.
      
      

Personalize suas solicitações POST

• Para incluir todas as propriedades, na seção Personalizar corpo da solicitação, selecione Incluir todas as propriedades. 
• Para incluir apenas propriedades específicas:
  
  • Na seção Personalizar corpo da solicitação, selecione Escolher propriedades específicas.
  • Clique no menu suspenso Escolher propriedade. Em seguida, clique em [objeto] neste fluxo de trabalho e selecione uma propriedade.
  • Para alterar o nome de uma propriedade no webhook, edite o campo de texto Nome da propriedade. Isso apenas atualizará o nome da propriedade na solicitação POST, não atualizará o nome da propriedade nem o nome interno no HubSpot. 
  • Para adicionar outra propriedade, clique em Adicionar propriedade.
  • Para remover uma propriedade, clique no ícone do caixote do lixo delete . 
     

Personalize suas solicitações GET

• Na seção Parâmetros de consulta , clique no menu suspenso Escolher propriedade. Em seguida, clique em [objeto] neste fluxo de trabalho e selecione uma propriedade.
• Para alterar o nome de uma propriedade no parâmetro de consulta, edite o campo de texto do nome da propriedade. Isso apenas atualizará o nome da propriedade na solicitação GET, não atualizará o nome da propriedade nem o nome interno no HubSpot. 

• Para adicionar outra propriedade, clique em Adicionar parâmetro de consulta.
• Para remover uma propriedade, clique no ícone do caixote do lixo delete . 
• Clique em Salvar.