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

# Webhooks de Flows

> Configure webhooks no workspace para receber atualizações dos flows em tempo real.

# Webhooks de Flows

Para acompanhar as atualizações dos flows, é recomendado que se configure um webhook no workspace para receber as atualizações sobre os flows em tempo real. É necessário [configurar um webhook no workspace](https://studio.posit.us/workspace/configuracoes) para receber esses eventos.

## Eventos de Flows

A tabela abaixo lista todos os eventos de flows que podem ser recebidos através dos webhooks do workspace:

| Evento           | Descrição                                                                             |
| ---------------- | ------------------------------------------------------------------------------------- |
| flow\_created    | Este evento é recebido quando um novo flow é criado                                   |
| flow\_updated    | Este evento é recebido quando um flow é atualizado                                    |
| flow\_published  | Este evento é recebido quando um flow é publicado                                     |
| flow\_throttled  | Este evento é recebido quando um flow é restrito                                      |
| flow\_deprecated | Este evento é recebido quando um flow é descontinuado                                 |
| flow\_blocked    | Este evento é recebido quando um flow é bloqueado                                     |
| flow\_deleted    | Este evento é recebido quando um flow é deletado                                      |
| flow\_sync       | Este evento é recebido quando o sistema da Positus força uma sincronização com a Meta |

<Info>
  É importante que seu Webhook retorne uma resposta HTTPS 200 OK às notificações. Caso contrário, o cliente da API do WhatsApp Business considerará essa notificação uma falha e tentará novamente após um atraso.
</Info>

## Estrutura do webhook

A estrutura dos webhooks recebidos relacionados a flows é a seguinte:

```json theme={null}
{
    "event": "flow_sync",
    "workspace": {
      "id": "d4026ecf-f7cf-418b-b44e-8c1d8808c57d",
      "name": "Conta teste Robbu",
      "business_id": "221123502254868",
      "waba_id": "1281352745326562"
    },
    "flow": {
      "id": "647e664e-a25e-4ea1-bc88-584293994210",
      "wa_id": "140652314281467",
      "status": {
        "id": 1,
        "code": "DRAFT",
        "description": "Rascunho"
      },
      "version": null,
      "name": "Flow teste",
      "categories": [
        {
          "id": 4,
          "code": "LEAD_GENERATION",
          "description": "Geração de leads"
        }
      ],
      "json": {
        "version": "3.1",
        "screens": [
          {
            "id": "WELCOME_SCREEN",
            "layout": {
              "type": "SingleColumnLayout",
              "children": [
                {
                  "type": "TextHeading",
                  "text": "Hello World"
                },
                {
                  "type": "TextBody",
                  "text": "Let's start building things!"
                },
                {
                  "type": "Footer",
                  "label": "Complete",
                  "on-click-action": {
                    "name": "complete",
                    "payload": []
                  }
                }
              ]
            },
            "title": "Welcome",
            "terminal": true,
            "success": true,
            "data": []
          }
        ]
      },
      "endpoint_encrypted": true,
      "endpoint_url": null
    }
  }
```