> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook de Falha na Implantação

> O webhook de falha na implantação é acionado quando ocorre um erro durante o processo de implantação de uma conversa. Aprenda a configurá-lo e gerenciá-lo neste artigo.

## Falhas em implantações

As implantações podem falhar por diferentes razões. Quando isso acontece, é importante estar informado para poder tomar as ações corretivas necessárias.

Por que as implantações podem falhar?

* **FAILURE**: Problema com a implantação após 3 tentativas falhadas
* **FAILURE\_BY\_HUMAN\_HANDOVER**: O usuário está falando com um agente
* **REVOKED**: A implantação foi cancelada
* **INVALID\_PHONE**: O celular não é um celular válido ou não tem WhatsApp
* **FAILURE\_BY\_RATE\_LIMIT**: Falhou porque a mensagem excederia o limite permitido pelo WhatsApp
* **COMPANY\_RATE\_LIMIT**: Excedeu o limite de sessões que foi solicitado pela empresa
* **FAILURE\_BY\_TIER\_CAPACITY**: Não há uma linha disponível e com capacidade para fazer a implantação
* **MISSING\_PARAMETER**: Faltou uma variável no HSM para ser preenchida
* **PARAMETER\_MISMATCH**: O número de variáveis enviadas não coincide com o número de variáveis do HSM
* **FAILURE\_BY\_BLOCKED\_CONTACT**: O contato foi bloqueado pela empresa
* **FAILURE\_BY\_OPTOUT\_CONTACT**: O contato optou por não receber mais comunicações da empresa
* **INVALID\_POLL**: Tentou enviar uma conversa eliminada ou desativada
* **CHARACTER\_LIMIT\_HEADER**: O cabeçalho do template HSM excede o limite de caracteres permitido pelo WhatsApp
* **CHARACTER\_LIMIT\_BODY**: O corpo do template HSM excede o limite de caracteres permitido pelo WhatsApp
* **FAILURE\_BY\_DISABLED\_HSM**: O template HSM enviado foi desabilitado pelo Meta
* **FAILURE\_BY\_SPAM\_RATE\_LIMIT**: O WhatsApp restringiu a linha do WhatsApp por fazer spam e não pode fazer mais implantações no momento
* **FAILURE\_BY\_EXPERIMENT\_NUMBER**: O WhatsApp está usando esse número para experimentos internos e não foi possível realizar a implantação
* **FAILURE\_BY\_UNABLE\_TO\_CONTACT**: Não foi possível realizar a implantação porque o usuário não está em capacidade de receber a mensagem (Não tem WhatsApp, tem uma versão obsoleta, etc.)

O webhook de falha na implantação permite que você fique atento a esses eventos e tome as ações necessárias de forma imediata.

## Como configurar um webhook de falha na implantação?

Para configurar um webhook de falha na implantação, você deve seguir os seguintes passos:

1. Entre no Treble.ai através da seguinte URL: <a class="article-link" href="https://app.treble.ai"><p>[https://app.treble.ai](https://app.treble.ai)</p><Icon icon="arrow-up-right-from-square" iconType="solid" /></a>
2. Vá para a seção **Configurações** e selecione **Webhooks**.
3. Você verá um campo de **URL do webhook**. Este é o endpoint ao qual será enviada a solicitação HTTP quando ocorrer uma falha na implantação.
4. Digite a URL do seu webhook no campo **URL do webhook**.
5. Clique no botão **Falha de Implantação** para habilitar este tipo de notificações.
6. Clique em **Salvar**.
7. Pronto! Agora, quando ocorrer uma falha em uma implantação no Treble, o webhook será acionado.

<img src="https://mintcdn.com/trebleai/X3Ys1WzX_gZPA4ia/images/webhook-center-deployment-failure.gif?s=4a5012269bd6c7a77092f86e8e253f94" alt="Configurar um webhook de falha na implantação" width="3452" height="1740" data-path="images/webhook-center-deployment-failure.gif" />
