> For the complete documentation index, see [llms.txt](https://comunidadezdg.gitbook.io/hub-zdg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://comunidadezdg.gitbook.io/hub-zdg/readme.md).

# Visão geral

O que o Hub ZDG faz, o que ele não faz e por onde começar.

O **Hub ZDG** é uma **ponte oficial** entre os canais da Meta (WhatsApp, Messenger e Instagram) e o seu sistema. Ele faz parte da assinatura da **Comunidade ZDG** e fica no ar em [**hub.zdg.com.br**](https://hub.zdg.com.br): você não precisa de servidor, não cria app na Meta e não passa pelo App Review.

{% hint style="info" %}
**Para quem é este guia:** alunos da Comunidade ZDG que vão conectar os canais e ligar o Hub a um sistema próprio, ao n8n, ao Typebot ou a outra automação. As seções **Primeiros passos** e **Conectar canais** não exigem programação. **Integrar** é para quem vai receber e enviar mensagens pelo seu sistema.
{% endhint %}

## Os três canais

| Canal                 | O que é                                                                                                        |
| --------------------- | -------------------------------------------------------------------------------------------------------------- |
| **WhatsApp Business** | A API oficial do WhatsApp (Cloud API), a mesma que as empresas grandes usam. Não é WhatsApp "web" nem QR Code. |
| **Messenger**         | As mensagens da sua **Página do Facebook**.                                                                    |
| **Instagram**         | O **Direct** da sua conta profissional do Instagram, e os avisos de comentários.                               |

## O que o Hub faz

1. **Conecta seus canais** pelo login oficial da Meta. Você clica em "Conectar", autoriza na janela da Meta e pronto. **Você não precisa criar app na Meta**, não precisa mexer em "App Secret" e não precisa configurar webhook no painel de desenvolvedor: tudo isso já está feito no app da plataforma.
2. **Recebe tudo o que chega** nesses canais (mensagens, confirmações de entrega e leitura, comentários) e **repassa para o endereço do seu sistema**. Esse endereço se chama **destino de webhook**.
3. **Envia mensagens** pelos seus canais por uma **API única**: o mesmo jeito de chamar serve para WhatsApp, Messenger e Instagram.

## O que o Hub não é

Para não criar expectativa errada:

* **Não é um sistema de atendimento.** Não tem tela de conversa, fila, atendente, etiqueta nem chatbot. Ele é a "tubulação": quem conversa com o cliente é o sistema que você liga nele (o seu próprio, um n8n, um Typebot, etc.).
* **Não usa WhatsApp não oficial.** Não lê QR Code e não usa o WhatsApp do celular.
* **Não publica posts**, não lê seu feed e não responde comentários. Ele só **recebe** os avisos de comentários do Instagram e repassa.
* **Não cria modelos (templates) do WhatsApp.** Os modelos são criados e aprovados no Gerenciador do WhatsApp da sua conta na Meta. O Hub lista os aprovados e envia.
* **Não faz disparo agendado nem campanha.** Ele envia quando o seu sistema chama a API.
* **Não guarda agenda de contatos.**

## Como uma mensagem passa pelo Hub

**Quando um cliente manda mensagem para você:**

```mermaid
flowchart LR
    C[Cliente] --> M[Meta<br>WhatsApp / Messenger / Instagram]
    M --> H[Hub ZDG<br>confere a origem, identifica a conta<br>e guarda no histórico]
    H --> S[Seu sistema<br>destino de webhook]
```

**Quando o seu sistema quer responder ou mandar uma mensagem:**

```mermaid
flowchart LR
    S[Seu sistema] -->|token de API do Hub| H[Hub ZDG<br>confere token, limite e formato]
    H --> M[Meta] --> C[Cliente]
```

O ponto principal: **o acesso aos seus canais (o "token da Meta") fica guardado só dentro do Hub** e nunca sai dele, nem para você. Seu sistema conversa com o Hub usando um **token de API próprio do Hub**, que você cria e pode cancelar quando quiser.

## Por onde começar

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Primeiro acesso</strong></td><td>Entre no painel e conheça as telas.</td><td><a href="/hub-zdg/primeiros-passos/primeiro-acesso.md">Primeiro acesso e senha</a></td></tr><tr><td><strong>Conectar canais</strong></td><td>WhatsApp, Messenger e Instagram pelo login oficial da Meta.</td><td><a href="/hub-zdg/conectar-canais.md">Conectar canais</a></td></tr><tr><td><strong>Receber mensagens</strong></td><td>Cadastre o seu sistema como destino de webhook.</td><td><a href="/hub-zdg/integrar/receber-webhooks.md">Receber: destinos de webhook</a></td></tr><tr><td><strong>Enviar mensagens</strong></td><td>Uma API única para os três canais.</td><td><a href="/hub-zdg/integrar/enviar-api.md">Enviar: a API do Hub</a></td></tr></tbody></table>

## Suporte

O suporte do Hub é técnico e por texto, pelo e-mail <suporte@zdg.com.br>. Não fazemos chamada de vídeo nem configuramos a sua integração.