Como Enviar o ID da Entrada Através de Webhooks

Introdução

Deseja transmitir o ID da entrada através do Webhooks addon? O ID da entrada, que é atribuído assim que o formulário é enviado, desempenha um papel vital na ligação das suas entradas do WPForms com um CRM externo para referências cruzadas. Neste tutorial, iremos guiá-lo através do processo usando um trecho de PHP simples.

Criando o formulário

Vamos começar criando um formulário e adicionando os campos necessários. Se você não tem certeza de como criar um formulário, pode consultar esta documentação para obter orientação.

Configurando o webhook

Para enviar o ID da entrada através de webhooks, precisamos começar habilitando o Webhooks addon. Se precisar de ajuda para configurar o Webhooks addon, por favor, confira este artigo.

Para ativar o addon, vá para o construtor de formulários, clique em Configurações e, em seguida, clique em Habilitar Webhooks. Você poderá inserir seu URL de webhook e mapear os campos do formulário para o Corpo da Solicitação, especificando as informações que deseja incluir no webhook.

Adicionando o snippet

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

Para qualquer assistência sobre como e onde adicionar trechos ao seu site, por favor, veja 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 é enviado, mas apenas para o ID do formulário 1899. Você precisará atualizar este número de ID do formulário para corresponder ao seu próprio ID. Se você não tem certeza de onde encontrar o número do ID do seu formulário, por favor, revise este tutorial.

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

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