Configuração de uma chamada de retorno de webhook URL

Antes de usar os nós de entrada compatíveis com webhook para receber notificações de um servidor, é necessário configurar o host, a porta, o endereço base externo URL, o certificado SSL e a senha SSL conforme necessário na chamada de retorno do webhook gerada em App Connect e associada ao evento URL.

Antes de Começar

Sobre esta tarefa

Use estas instruções para configurar um retorno de chamada de webhook URL.

Procedimento

  1. Clique no nó de entrada compatível com webhook e, em seguida, clique em Launch Connector Discovery para visualizar o callback do webhook URL vinculado ao evento.
    Por exemplo, Novo lead no Marketo é selecionado.
    Callback de webhook URL gerado no conector Marketo
  2. Para copiar o endereço URL para sua área de transferência, clique em O ícone que representa a cópia para a área de transferência.
    No retorno de chamada do webhook URL, http://ace-host:ace-port/webhooks/slack/RawMessage/imylH4CEIY034rvg3sKsQQhkZFVkNlJwCVhIxV6yGO-vIYTA8MWLZhLEZ0HLDVs1vfBPt6-dibTx6pqLcAV4vzQ, ace-host é o nome do host do servidor de integração e ace-port é a porta que o servidor de integração escuta.
  3. Opcional: Para configurar o retorno de chamada do webhook URL, substitua as seguintes propriedades URL noWebhookListenerdo arquivo server.conf.yaml .
    Observação: Você só precisa configurar oWebhookListenerno arquivo server.conf.yaml se você quiser personalizar essas configurações padrão.
    • Para iniciar seu ouvinte quando o servidor de integração for iniciado
    • Para proteger o endpoint do webhook com TLS
    • Se você configurar uma rota externa para o ponto de extremidade do webhook
    • startWebhookListener: Defina essa propriedade como 'Automatic', 'On', ou 'Off' com base em quando iniciar o ouvinte do webhook. A configuração padrão é 'Automatic'.
    • externalBaseUrl: A base externa URL a ser usada para construir o ponto de extremidade do webhook. Se não for especificado, a base externa URL é construída a partir da configuração do host ou da porta.
    • port: A porta do ouvinte para conectores de designer de webhooks. A configuração padrão é 3008.
    • host: O nome do host a ser vinculado. Se essa propriedade não for definida, ela será vinculada a um endereço disponível.
    • sslCertificate: Configure essa propriedade somente se o ponto de extremidade do webhook exigir um HTTPS URL. O tipo de certificado pode ser p12 ou pem.
    • sslPassword: O sslPassword é o caminho completo para a chave privada do servidor, que deve ser uma chave privada padrão e não criptografada (para pem), e a propriedade sslPassword especifica a frase secreta ou o alias da frase secreta do armazenamento de certificados (para p12).

    Como alternativa, se você estiver usando o nó de integração, execute o comando mqsireportproperties para exibir asWebhookListenerpropriedades do gerenciador de recursos para fazer as alterações necessárias.

  4. Se você estiver se conectando a um nó de entrada de webhook de conector baseado em Software como Serviço ( SaaS ) (por exemplo, Slack ou Eventbrite ) a partir de um servidor de integração local d IBM App Connect Enterprise, siga estas etapas:
    Observação: Se o seu servidor de integração estiver em uma rede privada, os provedores de SaaS, como Slack ou Eventbrite, não poderão acessar o retorno de chamada URL. A Eventbrite rejeita o registro automático do retorno de chamada do webhook URL se ele estiver inacessível, causando falhas na implantação.
    1. Abra seu arquivo server.conf.yaml e localize o arquivoWebhookListenerou execute o comando mqsireportproperties para exibir a seçãoWebhookListenerpropriedades do gerenciador de recursos.
    2. Configure o parâmetroexternalBaseUrlpara uma propriedade pública URL.

      Por exemplo, use um túnel ou serviço de roteamento para mapear o ouvinte local do webhook URL para um URL público. O serviço de túnel ou roteamento garante que o retorno de chamada do webhook hospedado localmente URL se torne acessível a partir da Internet pública.

    3. Reinicie seu App Connect servidor de integração para aplicar as novas configurações.
  5. Implemente o fluxo de mensagens que você criou. Para obter mais informações, consulte Implantação de soluções de integração.
    Depois de implantar o fluxo com o nó de entrada do webhook no servidor de integração, você poderá visualizar o URL real na guia Endpoints do fluxo de mensagens na interface do usuário da Web. Guia Endpoints com o host e a porta do webhook URL configurados no Marketo

    Em URL http://ibm-pf3xhkkm.dmain:3008/webhooks/slack/RawMessage/imylH4CEIY034rvg3sKsQQhkZFVkNlJwCVhIxV6yGO-vIYTA8MWLZhLEZ0HLDVs1vfBPt6-dibTx6pqLcAV4vzQ, ace-host é substituído pelo nome do host do servidor de integração em que o fluxo está implantado e ace-port é substituído pelo valor da porta padrão de 3008.

  6. Se o seu conector exigir um registro manual do retorno de chamada do webhook URL, registre manualmente o retorno de chamada do webhook App Connect gerado URL com o provedor de aplicativos:
    Depois que o retorno de chamada do webhook URL é registrado no provedor de aplicativos, o fluxo recebe os eventos do webhook enviados pelo provedor de aplicativos.