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

# Embedding (chat no card do Pipefy)

> Coloque a conversa de WhatsApp de um contato dentro do card do Pipefy, pelo código do card ou pelo app do Brainchat no Pipefy.

O Embedding mostra a conversa de WhatsApp de um contato dentro do card do Pipefy. Abra em **Developers → Embedding**. A tela tem duas abas: **Embedding** (código do iframe) e **SDK Pipefy** (app do Brainchat no Pipefy).

![Tela de Embedding com o botão Gerar Embed Key](https://mintcdn.com/stegia/Lm99ll5VN1TwpclF/images/developers/embedding.png?fit=max\&auto=format\&n=Lm99ll5VN1TwpclF\&q=85\&s=f3c248a4e2de9ac1f2c3fef24b5dac05)

Developers → Embedding

## Chave de embed

Cada canal tem uma **Embed Key** (`emb_...`). Ela vai no endereço do chat embutido:

```
https://brainchat.app/e/{embed_key}/phone/{telefone}
https://brainchat.app/e/{embed_key}/phone/{telefone}/card/{id_do_card}
```

A segunda forma separa a conversa por card, como um chamado próprio.

> [!WARNING]
>
> A chave de embed vale como senha: quem a tiver consegue abrir conversas e enviar mensagens pelo número desse canal. Se o canal ainda não tem chave, clique em **Gerar Embed Key**. Se ela vazar, use **Rotacionar Key**. Ao rotacionar, todas as integrações que usam a chave antiga param até você atualizar o código com a nova.

## Opção 1: código no card do Pipefy (aba Embedding)

**1. Crie os campos no card**

Um campo de telefone (ex.: **Número de Contato**) com o número do cliente.

**2. Copie o código**

Em **Código para Integração**, use **Copiar**. O código já traz a sua chave e usa o campo do telefone do card.

**3. Mostre no card**

Use um campo de conteúdo dinâmico (ou uma automação que preenche um campo com o código) na fase em que o chat deve aparecer.

## Opção 2: app do Brainchat no Pipefy (aba SDK Pipefy)

**1. Cadastre o app**

Em **Abrir Pipefy Developers**, crie o app colando o **Manifest URL** mostrado na tela e salve.

**2. Ative no pipe**

No pipe, abra **Gerenciar (Manage)** → **Ferramentas (Tools)** → aba **Apps**, localize o app e clique em **Enable**.

**3. Prepare os campos do card**

O card precisa ter o campo **Embed ID** (nome técnico `emb_id`, com a chave do canal) e um campo de telefone (**Telefone**, **WhatsApp**, **Phone** ou **Celular**, só dígitos). Use uma automação do pipe para preencher o Embed ID nos cards novos com o valor de **Embed Key (valor para a automação)**.

**4. Pronto**

Um item **BrainChat** aparece no menu do pipe e cada card ganha um botão com ícone do WhatsApp. Se o telefone mudar, o chat recarrega.

> [!NOTE]
>
> O SDK não lê campos dentro de registros de database conectados. Se o telefone estiver numa database, copie para um campo do card com uma automação.

O chat embutido só abre a conversa daquele telefone naquele canal.

Para atribuir, encerrar e anotar conversas pelo seu sistema, veja a [API de conversas](https://docs.brainchat.app/api/conversacoes.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.