Como Enviar o ID da Entrada Através de Webhooks

Introdução

Pretende transmitir o ID da entrada através do complemento Webhooks? O ID da entrada, que é atribuído assim que o formulário é submetido, desempenha um papel vital na ligação das suas entradas WPForms com um CRM externo para referências cruzadas. Neste tutorial, vamos guiá-lo através do processo utilizando um simples trecho de código PHP.

Criação do formulário

Vamos começar por criar um formulário e adicionar os campos necessários. Se não tiver a certeza de como criar um formulário, pode consultar esta documentação para obter orientação.

Configuração do webhook

Para enviar o ID da entrada através de webhooks, precisamos de começar por ativar o complemento Webhooks. Se precisar de assistência na configuração do complemento Webhooks, consulte este artigo.

Para ativar o complemento, vá ao construtor de formulários, clique em Definições e, em seguida, clique em Ativar Webhooks. Poderá introduzir o seu URL de webhook e mapear os campos do formulário para o Corpo do Pedido, especificando as informações que pretende incluir no webhook.

Adição do trecho de código

Em seguida, é hora de copiar o trecho para o nosso site.

Para qualquer assistência sobre como e onde adicionar trechos ao seu site, consulte este tutorial.

/**
 * Send the entry id through webhooks request.
 *
 * @link https://wpforms.com/developers/how-to-send-the-entry-id-through-webhooks/
 */

function wpf_dev_webhooks_process_delivery_request_options( $options, $webhook_data, $fields, $form_data, $entry_id ) {
    
	// Optional, you can limit to specific forms. Below, we restrict output to
    // form #1899.
    if ( absint( $form_data[ 'id' ] ) !== 1899 ) {
        return $options;
    }
	
	$body = ! is_array( $options[ 'body' ] ) ? json_decode( $options[ 'body' ], true ) : $options[ 'body' ];
	
	// Create a new entry and assign the entry_id
	$body[ 'entry_id' ] = $entry_id;
	
	// Format request data.
	if ( !empty( $options[ 'method' ] ) && $options[ 'method' ] !== 'GET' && $webhook_data[ 'format' ] === 'json' ) {
		
		// Encode request body.
		$options[ 'body' ] = wp_json_encode( $body );
	}
	
	return $options;
}

add_filter( 'wpforms_webhooks_process_delivery_request_options', 'wpf_dev_webhooks_process_delivery_request_options', 100, 5);

Com este trecho, vamos adicionar uma variável adicional ao webhook chamada entry_id e atribuir este número de ID que é criado pelo WPForms quando o formulário é submetido, mas apenas para o ID de formulário 1899, terá de atualizar este número de ID de formulário para corresponder ao seu próprio ID. Se não tiver a certeza de onde encontrar o seu número de ID de formulário, reveja este tutorial.

Agora, quando vir as informações enviadas do webhook, notará não só os nomes dos seus campos mapeados, mas também o ID da entrada.

E é tudo! Agora pode passar o ID da entrada através do seu webhook. Gostaria também de enviar as informações de geolocalização no webhook? Consulte o nosso artigo sobre Como Enviar Geolocalização Através de Webhooks.