# Introdução

Os Webhooks são uma forma de **envio de informações**, que são passadas como um gatilho, sempre que um evento acontece.

{% hint style="info" %}
**A configuração de Webhooks requer um corpo técnico por parte de sua equipe, além de ferramentas externas para sua total aplicabilidade.**
{% endhint %}

***

## Configurações

Para utilizar os webhooks em sua aplicação, é necessário configurar adequadamente tanto o sistema remetente quanto o receptor dos eventos. A correta configuração dos webhooks garantirá a entrega confiável das informações desejadas no momento adequado.

{% content-ref url="/pages/pCXde0uF5KUdI2PRIJrB" %}
[Configuração](/docs/webhooks/configuracao.md)
{% endcontent-ref %}

***

## Ambiente de testes

Antes de implementar os webhooks em produção, é recomendado utilizar um ambiente de teste. Esse ambiente permite simular o envio dos eventos para seu webhook, utilizando uma configuração similar à do ambiente de produção, porém sem afetar dados reais da aplicação.

Ao usar o ambiente de teste, você pode verificar se sua integração está funcionando corretamente e depurar quaisquer problemas antes de fazer a implementação final.

{% content-ref url="/pages/BQm6RMGwsfyRtyytJgsM" %}
[Ambiente de testes](/docs/webhooks/sandbox.md)
{% endcontent-ref %}

***

## Histórico de eventos

A seção do histórico de eventos é uma ferramenta valiosa fornecida pela nossa plataforma. Ele permite que você visualize todos os eventos enviados pelos webhooks, facilitando o rastreamento e a depuração de problemas.

No histórico de eventos, você pode filtrar e pesquisar eventos específicos com base em critérios . Ao selecionar um evento enviado, você terá acesso aos detalhes completos do histórico, incluindo informações como hora do envio, tipo de evento, produto relacionado e status do processamento.

{% content-ref url="/pages/OI9mnPUgsMKxIzSV3iLn" %}
[Histórico de eventos](/docs/webhooks/historico.md)
{% endcontent-ref %}

***

## Debugging

O uso dos webhooks também requer a capacidade de realizar debugging para identificar possíveis falhas ou comportamentos inesperados na integração. Durante o processo de configuração ou ao analisar um evento específico no histórico de eventos, é importante examinar as respostas recebidas pelo seu endpoint e verificar se os dados estão sendo interpretados corretamente.

Caso ocorram erros na entrega dos webhooks ou problemas na interpretação dos dados recebidos, é essencial revisar cuidadosamente as configurações da regra do webhook e garantir que sua aplicação esteja preparada para lidar corretamente com os diferentes tipos de eventos recebidos.

{% content-ref url="/pages/1hWmcV0TT1H3JQD60WRd" %}
[Debugging](/docs/webhooks/debugging.md)
{% endcontent-ref %}

***

## Proteja seu endpoint

Ao configurar seus endpoints para receberem webhooks, é fundamental implementar medidas adequadas para proteger sua API contra possíveis ameaças externas. Recomenda-se utilizar autenticação adicional por meio do uso de tokens ou chaves secretas compartilhadas entre a Hubla e sua aplicação. Essa autenticação garante que apenas solicitações legítimas provenientes da nossa plataforma sejam aceitas pelo seu sistema.

Além disso, considere implementar mecanismos adicionais de segurança, como validação do conteúdo recebido e verificação da origem das solicitações para proteger seu endpoint contra ataques maliciosos.

{% content-ref url="/pages/EcStQMBVisv8LYZQYJoC" %}
[Proteja seu endpoint](/docs/webhooks/proteja-seu-endpoint.md)
{% endcontent-ref %}

***

## Eventos webhook

Estamos constantemente aprimorando nossos webhooks para oferecer uma experiência mais robusta e flexível. Com a versão 2.0.0 dos eventos de webhook, introduzimos melhorias significativas em termos de desempenho, escalabilidade e recursos disponíveis.

Certifique-se de atualizar suas configurações e adaptar seu sistema para lidar com os eventos da versão 2.0.0, a fim de aproveitar ao máximo as melhorias e recursos adicionais disponíveis.

{% content-ref url="/pages/OC6FiSOKbEv2g7MKLdiJ" %}
[Eventos v2.0.0](/docs/webhooks/eventos-v2.md)
{% endcontent-ref %}

***

## Boas práticas

A Hubla preparou alguns tópicos de boas boas práticas, com isso, você poderá integrar efetivamente aos webhooks da nossa plataforma, proporcionando uma experiência confiável tanto para sua aplicação quanto para seus usuários.

{% content-ref url="/pages/OLbaAV59lk3RyJBbF81O" %}
[Boas práticas](/docs/webhooks/boas-praticas.md)
{% endcontent-ref %}

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hubla.gitbook.io/docs/webhooks/introducao.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.