### [Envio de dados de geolocalização através de webhooks](https://wpforms.com/developers/how-to-send-geolocation-through-webhooks/)

**Publicado:** 5 de agosto de 2021
**Autor:** David Ozokoye

**Excerto:** Este tutorial irá mostrar-lhe como enviar a geolocalização através de webhooks utilizando um pequeno snippet de PHP. 

**Conteúdo:**

Gostaria de enviar geolocalização através de webhooks? Os dados de geolocalização podem ser uma adição valiosa à carga útil do seu webhook, fornecendo informações específicas sobre a localização dos envios dos seus formulários.

Neste tutorial, iremos guiá-lo pelo processo de incluir dados de geolocalização nos seus webhooks utilizando um fragmento de código PHP.

---

Antes de começar, certifique-se de que o WPForms está [instalado e ativado](https://wpforms.com/docs/install-wpforms-plugin/ "Instalar o plugin WPForms") no seu site WordPress e que [verificou a sua licença](https://wpforms.com/docs/verify-wpforms-license/ "Verificar a sua licença").

## Criar o formulário

Primeiro, terá de [criar um formulário](https://wpforms.com/docs/creating-first-form/) ou editar um já existente para aceder ao criador de formulários. No criador de formulários, adicione um [campo de endereço](https://wpforms.com/docs/how-to-customize-the-address-field/ "Personalizar o campo de endereço") e ative a geolocalização. Se precisar de ajuda para criar um formulário com a geolocalização ativada, [consulte esta documentação.](https://wpforms.com/docs/how-to-install-and-use-the-geolocation-addon-with-wpforms/ "Complemento de geolocalização")

![Crie o seu formulário, ative o preenchimento automático e exiba o mapa no campo de endereço para enviar valores de geolocalização através de webhooks](https://wpforms.com/wp-content/uploads/2024/11/form-builder.png)## Configurar o Webhook

Depois de configurar o complemento de geolocalização e utilizá-lo no seu formulário, terá de configurar os webhooks para o formulário.

No criador de formulários, navegue até **Configurações » Webhooks**. Uma vez aqui, ative a opção **Ativar Webhooks**.

![Ativar Webhooks](https://wpforms.com/wp-content/uploads/2024/11/enable-webhooks.png)Pode então prosseguir e introduzir o URL do seu webhook no campo **URL da solicitação**. Na secção **Corpo da solicitação**, terá de definir as informações que pretende enviar através do webhook, incluindo o mapeamento dos campos relevantes do seu formulário.

![mapeie os campos do seu formulário para os nomes das variáveis e insira a URL do webhook.](https://wpforms.com/wp-content/uploads/2024/11/webhooks-data.png)**Nota:** Para mais detalhes sobre como configurar e utilizar o Complemento Webhooks no WPForms, não deixe de consultar o nosso tutorial sobre o [Complemento Webhooks](https://wpforms.com/docs/how-to-install-and-use-the-webhooks-addon-with-wpforms/).

Para efeitos deste tutorial, estamos a utilizar o [Webhook.site](https://webhook.site/) para testar se as nossas informações estão a ser enviadas através do nosso webhook. Ao configurar o seu webhook, deverá utilizar o URL do webhook para a fonte externa para a qual está a enviar e atribuir as suas variáveis.

É importante lembrar que cada fonte externa que aceita webhooks recebidos pode ter formas diferentes de configurar variáveis para enviar as informações. Terá de pesquisar essa fonte externa para se certificar de que não precisa de criar manualmente as suas variáveis dentro dessa fonte, de modo a garantir que os nomes das variáveis correspondem ao que está a atribuir no construtor de formulários.

## Adicionar o Snippet

Agora é hora de adicionar o snippet. Para qualquer ajuda sobre como e onde adicionar snippets ao seu site, [consulte este tutorial](https://wpforms.com/developers/how-to-add-custom-php-or-javascript-for-wpforms/ "Como adicionar PHP ou JavaScript personalizado para o WPForms").

Com este snippet, vamos adicionar uma variável adicional ao webhook chamada **entry\_id** e atribuir este número de ID criado pelo WPForms quando o formulário é enviado, mas apenas para o ID do formulário **1899**; terá de atualizar este número de ID do formulário para corresponder ao seu próprio ID. Se não tiver a certeza de onde encontrar o número de ID do seu formulário, [consulte este tutorial](https://wpforms.com/developers/how-to-locate-form-id-and-field-id/ "Como localizar o ID do formulário e o ID do campo").

Agora, quando vir as informações enviadas pelo webhook, irá notar que não só os nomes dos campos mapeados estão lá, mas também a localização.

![com este trecho de código, pode enviar a geolocalização através de webhooks](https://wpforms.com/wp-content/uploads/2022/10/wpforms-send-gelocation-webhook.jpg)É tudo o que precisa para enviar o valor da localização utilizando um webhook.

A seguir, gostaria de enviar também valores de campos de uma **Caixa de seleção**, **Menu suspenso** ou **Escolha múltipla**? Consulte o nosso tutorial para aprender [como enviar valores de campos com webhooks](https://wpforms.com/developers/how-to-send-field-values-with-webhooks/ "Como enviar valores de campos com webhooks").

**Categorias:** Tutoriais

**Etiquetas:** PHP, Webhooks

---

