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

# Configurações e conta

> Cadastro, login por código, usuários e papéis, perfil, assinatura, auditoria, credenciais de API e as configurações gerais da sua conta

Esta página reúne tudo o que é da **conta** e do **acesso** ao painel: como criar a conta e entrar, quem pode fazer o quê, os dados do seu perfil, o plano contratado, o histórico de alterações e as configurações que valem para todos os envios.

## O que fica no menu Configurações

O menu **Configurações** da barra lateral agrupa as telas abaixo. Algumas só aparecem em certas condições.

| Item do menu | Para que serve | Quando aparece |
| - | - | - |
| **Geral** | Idioma dos envios, fuso horário, transcrição de áudios e destinatário de teste | Sempre |
| **Templates de Email** | Fonte, cores, cabeçalho e rodapé dos e-mails. Veja [E-mail](https://docs.octasend.com.br/guias/email.md) | Sempre |
| **Design System** | Aparência padrão dos elementos de e-mail. Veja [Design system](https://docs.octasend.com.br/plataforma/design-system.md) | Sempre |
| **Claude Design** | Guarda o acesso ao Claude Design para importar designs privados. Veja [Claude Design](#claude-design) | Sempre |
| **Canais** | Conexão de cada canal de envio. Veja os guias, como [WhatsApp](https://docs.octasend.com.br/guias/whatsapp.md) | Sempre |
| **Integrações** | Plataformas externas que disparam suas comunicações, como a [Nuvem Shop](https://docs.octasend.com.br/integracoes/nuvemshop.md) | Sempre |
| **Instalação** | Tag do seu site e domínios autorizados. Veja [OctaTag](https://docs.octasend.com.br/plataforma/octatag.md) | Sempre |
| **MCP Server** | Conectar o Claude Code à sua conta. Veja [MCP Server](https://docs.octasend.com.br/api-reference/mcp-server.md) | Sempre |
| **OAuth Clients** | Credenciais da API | Sempre |
| **Assinatura** | Plano contratado e pagamento. Só usuários **MASTER** assinam, trocam ou cancelam | Sempre |
| **Fila de WhatsApp** | Fila de envios do WhatsApp conectado por QR code. Veja [WhatsApp](https://docs.octasend.com.br/guias/whatsapp.md) | Só com um WhatsApp por QR code (Evolution) conectado |
| **Usuários** | Convidar e gerenciar as pessoas da conta | Só para usuários **MASTER** |
| **Perfis de acesso** | Definir o que cada pessoa da conta pode ver e fazer, página por página. Veja [Perfis de acesso](#perfis-de-acesso) | Só para usuários **MASTER** |
| **Auditoria** | Histórico de alterações de cadastro | Só para usuários **MASTER** |
| **Documentação** | Abre esta documentação em outra aba | Sempre |

## Criar sua conta

O cadastro não tem senha: você confirma o e-mail com um código e já entra no painel.

**1. Informe seu nome**

O nome completo também vira o nome da sua conta.

**2. Informe seu e-mail**

É com ele que você vai entrar no painel. Um e-mail só pode ter um cadastro: se ele já existir, o cadastro é recusado com um aviso de e-mail já registrado. Nesse caso, entre pelo login com código.

**3. Informe seu telefone**

Obrigatório, com o país escolhido na lista. Nesta etapa também aparece uma verificação de segurança, que precisa ser concluída para seguir.

**4. Digite o código recebido**

A OctaSend envia um código de 6 dígitos. Ao preencher o sexto dígito, o login acontece sozinho. Se o código não chegar, use **Reenviar código** (liberado 30 segundos depois do envio anterior). Cada reenvio pede a verificação de segurança de novo (até 5 pedidos de código por hora).

O que acontece ao criar a conta:

* A conta nasce no plano **Free**, com os canais **E-mail** e **WhatsApp** liberados.
* Quem se cadastrou vira **MASTER** da conta.
* O idioma padrão e o de fallback começam em **Português (Brasil)** e o fuso em **São Paulo (GMT-3)**. Dá para mudar depois em **Configurações → Geral**.
* Enquanto a conta não tiver nenhum canal ativo, uma faixa no topo do painel diz **Configure um canal para começar a usar a plataforma** e leva você, com o botão **Configurar canal**, para **Configurações → Canais**. Quem não pode editar canais vê o aviso pedindo a um administrador da conta que configure um. A faixa some assim que existir pelo menos um canal ativo.
* Se você chegou ao cadastro escolhendo um plano pago na página de planos, depois do código você vai direto para **Assinatura** com esse plano selecionado.

A página de cadastro tem seletor de idioma (PT, EN, ES) no topo.

## Entrar com código

O painel não usa senha. Para entrar:

**1. Digite seu e-mail**

Conclua a verificação de segurança e clique em **Enviar código**.

**2. Digite o código**

O código tem 6 dígitos e chega por e-mail — e também pelo WhatsApp, quando o seu perfil tem telefone e a notificação por WhatsApp está ligada. Ao completar o sexto dígito, o login é feito automaticamente. Colar o código inteiro também funciona.

Regras do código:

| Regra | Valor |
| - | - |
| Tamanho | 6 dígitos |
| Validade | 10 minutos |
| Tentativas por código | 5 — depois disso, o código deixa de valer |
| Novo pedido | Invalida o código anterior ainda não usado |
| Intervalo para reenviar | 30 segundos |
| Pedidos de código por e-mail | Até 5 por hora |

* Se o e-mail não tiver cadastro, você é levado para a página de cadastro com o e-mail já preenchido.
* Código errado, vencido ou esgotado mostra **Código inválido ou expirado**. Peça um novo com **Reenviar código**.
* Se a falha for do lado da OctaSend, a tela diz **Não foi possível concluir por uma falha nossa. Tente de novo em instantes.** Isso não quer dizer que o código estava errado. Aguarde um pouco e tente de novo; se aparecer **Código inválido ou expirado**, peça um novo com **Reenviar código**.
* **Reenviar código** fica na própria etapa do código: enquanto conta os 30 segundos, o botão mostra **Reenviar em Ns**. Depois disso, conclua a verificação de segurança, que também aparece nesta etapa (a tela lembra: **Conclua a verificação de segurança acima para reenviar o código.**), e clique em **Reenviar código**. O código novo é enviado na hora, sem voltar à etapa do e-mail, e o código anterior deixa de valer.
* Para trocar o e-mail digitado, use **Usar outro e-mail**.
* Um usuário desativado não recebe código e não consegue entrar.

Para sair, abra o menu do seu nome, no rodapé da barra lateral, e clique em **Sair**.

## Usuários e papéis

Cada pessoa que acessa o painel é um usuário da conta, com um de dois papéis. O papel vale **só na conta em que foi definido**: quem tem acesso a mais de uma conta pode ser MASTER numa e PADRÃO em outra.

| O que a pessoa pode fazer | MASTER | PADRÃO |
| - | - | - |
| Usar as telas do painel (comunicações, contatos, canais, automações etc.) | Sim | Sim |
| Alterar **Configurações → Geral** | Sim | Sim |
| Criar e revogar credenciais em **OAuth Clients** | Sim | Sim |
| Ver os planos e o plano atual em **Assinatura** | Sim | Sim |
| Assinar, trocar ou cancelar o plano em **Assinatura** | Sim | Não |
| Salvar ou remover o sessionKey em **Claude Design** | Sim | Não |
| Editar o próprio perfil | Sim | Sim |
| Ver e usar **Usuários** (convidar, editar, mudar papel, desativar) | Sim | Não |
| Ver **Auditoria** | Sim | Não |
| Gerenciar **Perfis de acesso** | Sim | Não |
| Substituir ou desligar uma tag do site em **Instalação** | Sim | Não |
| Ver o segredo de **Verificação de identidade** (canais In-app e Push Notification), gerar um novo e ligar ou desligar a exigência | Sim | Não |

Para um usuário **PADRÃO**, os itens **Usuários** e **Auditoria** nem aparecem no menu; abrir a tela de usuários pelo endereço leva de volta ao dashboard. Em **Assinatura**, **Claude Design**, **Instalação** e na seção **Verificação de identidade** dos canais, a tela abre normalmente, mas as ações reservadas ao MASTER ficam desabilitadas ou ocultas, com um aviso pedindo a um usuário MASTER da conta que faça a alteração. Na verificação de identidade, o PADRÃO não vê nem o segredo.

### Convidar um usuário

Em **Configurações → Usuários**, clique em **Convidar usuário** e preencha:

| Campo | Obrigatório | Observação |
| - | - | - |
| **Nome** | Sim | |
| **Email** | Sim | É o e-mail de login da pessoa |
| **Telefone (WhatsApp)** | Não | Se preenchido, um número curto demais é recusado com **Telefone inválido** |
| **Papel** | Sim | **PADRÃO** (já vem selecionado) ou **MASTER**. Vale nesta conta |

Ao clicar em **Convidar**, a pessoa já fica ativa na conta e a OctaSend envia um aviso de convite para o e-mail informado. Ela entra pelo login com código, usando esse e-mail — não há senha para definir.

> [!NOTE]
>
> Um e-mail só pode pertencer a um usuário. Se ele já tiver cadastro na OctaSend, inclusive em outra conta, o convite é recusado com um aviso de e-mail já registrado.

### Gerenciar os usuários

A lista mostra todas as pessoas com acesso à conta, inclusive quem está usando outra conta no momento, com **Nome**, **Email**, **Papel** (o papel nesta conta), **Status** (Ativo ou Inativo), **Criado em** e **Último acesso**.

* **Mudar o papel** — escolha MASTER ou PADRÃO direto na coluna **Papel**. A mudança é gravada assim que você escolhe e vale só nesta conta: as outras contas da pessoa ficam como estão.
* **Editar** — altera nome e telefone. O e-mail não pode ser alterado.
* **Desativar** — pede confirmação. O usuário para de receber código de login e, se estiver com o painel aberto, é desconectado na próxima vez que o painel carregar. Os dados que ele criou continuam na conta.
* **Reativar** — devolve o acesso a um usuário inativo.

Não existe exclusão de usuário: quem sai da equipe é desativado.

> [!NOTE]
>
> Editar nome e telefone, desativar e reativar valem para **todas as contas** da pessoa, não só para esta. Por isso, se a pessoa também usa uma conta em que você não é MASTER, a alteração é recusada e nada é gravado: nesse caso, fale com o suporte da OctaSend. Mudar o papel continua valendo por conta, e o seu próprio nome e telefone você sempre pode editar.

> [!WARNING]
>
> A conta precisa ter sempre pelo menos um **MASTER ativo**. Por isso não é possível rebaixar para PADRÃO nem desativar o último MASTER ativo. Ao desativar alguém, essa regra é conferida em cada conta da pessoa. Também não é possível desativar a si mesmo.

## Perfis de acesso

Além do papel **MASTER** ou **PADRÃO**, cada pessoa tem um **perfil de acesso**, que define o que ela vê e faz em cada página. Em **Configurações → Perfis de acesso** (só para usuários **MASTER**), você cria e ajusta os perfis. Todo usuário tem sempre um perfil.

| Perfil | Como é |
| - | - |
| **Master** | Acesso a tudo o que a conta tem habilitado. Não pode ser alterado. |
| **Padrão** | Já existe em toda conta, com todas as permissões (o acesso que os usuários PADRÃO já tinham). Pode ser ajustado. |
| **Perfis seus** | Criados por você, do zero ou duplicando outro perfil. |

A lista mostra **Perfil**, **Usuários** (quantas pessoas usam) e **Permissões** (quantas estão marcadas). No menu de cada linha: **Editar**, **Duplicar** e **Excluir**. Um perfil só pode ser excluído quando nenhum usuário o usa: mova as pessoas para outro perfil antes.

**1. Crie o perfil**

Clique em **Novo perfil**, dê um **Nome** e, se quiser, uma **Descrição**.

**2. Marque as permissões**

Na matriz **Permissões**, marque o que o perfil pode fazer em cada página. **Visualizar** libera a página; as demais ações dependem dela.

**3. Salve e atribua**

Salve o perfil e escolha-o para cada pessoa em **Configurações → Usuários**.

As permissões são organizadas por grupo do menu (por exemplo, **Mensagens**, **Automações**, **E-commerce**, **Conteúdo rico**, **Tours**, **Pesquisas**, **Cookies (LGPD)**, **Popups**, **Campanhas**, **Bots** e **Configurações**). Cada página tem as ações que fazem sentido para ela:

| Ação | Exemplo de uso |
| - | - |
| **Visualizar** | Abrir a página e ver os dados. |
| **Criar**, **Editar**, **Excluir** | Gravar mudanças. |
| **Importar**, **Exportar** | Planilhas e arquivos. |
| **Criar e disparar** | Campanhas. |
| **Enviar teste**, **Responder**, **Enviar**, **Atribuir** | Comunicações e conversas. |
| **Ativar e pausar** | Automações. |
| **Publicar** | Conteúdo rico, tours, pesquisas, cookies e popups. |
| **Moderar** | Avaliações e dúvidas de produtos. |
| **Gerenciar**, **Enviar documento** | Fila do WhatsApp e base de conhecimento. |

Pontos de atenção:

* Páginas de módulos opcionais (como **Popups**, **Cookies (LGPD)**, **Campanhas** e **Avaliações de produtos**) só têm efeito quando o módulo está ligado na conta.
* Uma página que o perfil não pode abrir some do menu. Os botões de ação que o perfil não permite ficam ocultos, e os editores abrem em somente leitura quando o perfil só tem **Visualizar**.
* O bloqueio vale também no servidor para o que envia mensagens, gasta dinheiro, apaga dados, mexe em credenciais ou dá acesso.
* **Integrações:** com **Editar**, a pessoa conecta, configura e desconecta a loja; com **Visualizar**, vê os cartões e a tela de eventos, sem os botões que mudam algo.
* Quem muda um perfil precisa ser MASTER; a mudança vale para todas as pessoas que usam o perfil.

## Meu perfil

Abra o menu do seu nome, no rodapé da barra lateral, e clique em **Editar perfil**.

* **Nome completo** — obrigatório.
* **Email** — só leitura; é o e-mail de login.
* **Telefone** — opcional; se preenchido, um número curto demais é recusado com **Telefone inválido**.

Na seção **Notificações** você escolhe por onde recebe os avisos da plataforma, como o código de login:

* **Email** — sempre ativo, não pode ser desligado.
* **WhatsApp** — só pode ser ligado com um telefone cadastrado no perfil. Vem ligado por padrão.

## Tema e idioma do painel

No mesmo menu do seu nome, no rodapé da barra lateral:

* **Tema claro / Tema escuro** — alterna a aparência do painel. Sem escolha, o painel abre no tema escuro.
* **Português / English / Español** — muda o idioma da interface. Sem escolha, o painel segue o idioma do navegador e, se ele não for um desses três, usa português.

As duas escolhas ficam salvas no navegador, então valem para aquele navegador e não acompanham você em outro computador.

> [!NOTE]
>
> O idioma do painel não muda o idioma das mensagens enviadas — isso é definido em **Configurações → Geral**. Algumas telas ainda aparecem só em português.

## Trocar de conta

Se o seu usuário tiver acesso a mais de uma conta, aparece **Trocar tenant** no rodapé da barra lateral. Escolha a conta na lista: a conta atual aparece marcada, e o painel recarrega já na conta escolhida.

O acesso de um usuário a várias contas é liberado pela OctaSend. O papel (MASTER ou PADRÃO) é definido em cada conta: ao trocar de conta, os menus e as ações reservadas ao MASTER (**Usuários**, **Auditoria**, **Assinatura**, **Claude Design**, a tag em **Instalação** e a verificação de identidade dos canais) seguem o seu papel na conta escolhida.

## Geral

Em **Configurações → Geral** ficam as configurações da conta que valem para todos os usuários.

### Idioma, fuso e limite

| Campo | O que faz |
| - | - |
| **Idioma padrão** | Idioma usado quando o envio não informa um idioma — por exemplo, uma chamada à API sem o parâmetro `language` |
| **Idioma de fallback** | Segunda opção, quando a comunicação não tem template no idioma pedido nem no idioma padrão |
| **Fuso horário** | Define o que conta como "hoje" (inclusive a virada do limite diário), como os números são agrupados por dia no dashboard e nas métricas de mensagens, conversas de WhatsApp, e-commerce e automações, o horário do agendamento e as datas das [campanhas](https://docs.octasend.com.br/plataforma/campanhas.md), as horas mostradas em [Logs de mensagens](https://docs.octasend.com.br/plataforma/logs-de-mensagens.md) e os filtros por dia de Logs e da Auditoria |
| **Limite diário de mensagens** | Quantas mensagens a conta pode enviar por dia. Vazio significa ilimitado; o menor valor aceito é 1. Veja *Limite diário de mensagens*, logo abaixo |

Os idiomas disponíveis são Português (Brasil), English, Español, Français, Deutsch, Italiano, 日本語 e 中文. Clique em **Salvar Configurações** para gravar.

#### Limite diário de mensagens

Com um número preenchido, a OctaSend para de enviar quando a conta atinge esse total no dia.

* **O que conta:** cada envio a um canal conta 1. Uma mensagem para o mesmo destinatário por e-mail e por WhatsApp conta 2. Contam os envios pela API (único e em lote), campanhas, automações, eventos e carrinho abandonado das integrações de loja, mensagens adiadas pelo limite por minuto e o botão **Enviar teste** dos editores.
* **O que não conta:** as respostas do chatbot e as enviadas por um atendente nas conversas de WhatsApp, as mensagens recebidas e as mensagens da própria plataforma: o código de acesso ao painel, os convites de usuário, as boas-vindas e os avisos do [Token Control](https://docs.octasend.com.br/plataforma/token-control.md). Essas mensagens também nunca são barradas pelo limite.
* **Quando o dia vira:** à meia-noite, no **Fuso horário** da conta. Se o fuso gravado na conta for inválido, vale o de São Paulo, e o limite continua valendo.
* **Acima do limite:** o canal não é chamado e o envio fica em [Logs de mensagens](https://docs.octasend.com.br/plataforma/logs-de-mensagens.md) com o status **Falhou** e o motivo **Limite diário de mensagens atingido**. Na API, a resposta continua HTTP 200 e o canal volta com `status: "failed"` e `error_code: "daily_limit_reached"`. Veja [Enviar mensagens](https://docs.octasend.com.br/api-reference/enviar-mensagens.md).
* **Campanhas** não viram uma fila de falhas: quando a conta atinge o limite no meio do envio, a campanha fica **Pausada** e os contatos que faltam esperam. Ela volta a enviar sozinha à meia-noite, no fuso da conta. Veja [Campanhas](https://docs.octasend.com.br/plataforma/campanhas.md).
* **Aumentar o limite** no mesmo dia libera o saldo novo na hora para os envios novos, mas não adianta a volta de uma campanha pausada. Deixar o campo vazio remove o limite.
* **Definir o limite no meio do dia** já considera todos os envios feitos desde a meia-noite: a OctaSend conta os envios do dia mesmo quando a conta está sem limite.

Abaixo do campo, a tela mostra o uso do dia, por exemplo **Hoje: 1.250 de 5.000 mensagens usadas.** Quando o limite é atingido, aparece o aviso **Limite de hoje atingido**, explicando que novos envios são recusados até a meia-noite, no fuso da conta, e que você pode aumentar o limite ou deixar o campo vazio para liberar agora.

#### Como o idioma do template é escolhido

Para cada canal de uma comunicação, a OctaSend procura um template ativo nesta ordem e usa o primeiro que existir:

1. O idioma pedido no envio (ex.: `pt-BR`).
2. A base desse idioma (ex.: `pt`, para um pedido em `pt-BR`).
3. O **Idioma padrão** da conta.
4. O **Idioma de fallback** da conta.
5. Inglês (`en`).

Se nenhum desses existir e o canal tiver **um único** template ativo, ele é usado no idioma em que estiver. Com dois ou mais templates e nenhum idioma compatível, o envio daquele canal fica como **Ignorado** no log, com o motivo registrado — escolher um idioma qualquer poderia mandar a mensagem no idioma errado.

### Transcrição de áudios

Na seção **Conversas**, a opção **Transcrição de áudios** define o que fazer com os áudios que seus clientes mandam pelo WhatsApp. A escolha é salva assim que você clica.

| Opção | Comportamento |
| - | - |
| **Desligada** (padrão) | Os áudios recebidos não são transcritos e o bot não responde mensagens de voz |
| **Automática** | Todo áudio recebido é transcrito assim que chega |
| **Ao clicar** | Você escolhe quais áudios transcrever na conversa. Em conversas com o bot ativo, o áudio é transcrito sempre, para o bot poder responder |

Áudios com mais de 5 minutos não são transcritos. A transcrição usa IA da OpenAI; se você cadastrou a sua própria chave da OpenAI (veja **Chave própria de IA**, mais abaixo), ela é usada e o consumo entra no seu limite. As conversas ficam em [WhatsApp: conversas e grupos](https://docs.octasend.com.br/plataforma/whatsapp-conversas-e-grupos.md).

### Destinatário de teste

O card **Destinatário de Teste** guarda para quem vai o botão **Enviar teste** dos editores de template, para você não precisar digitar um contato toda vez:

* **Destinatário (user\_id)** — o identificador do usuário no seu sistema, usado por canais como Web push e In-app.
* **E-mail**
* **Telefone (com DDI)**

Os dados são **salvos automaticamente** no navegador, separados por usuário e por conta: outra pessoa no mesmo computador, ou você mesmo em outra conta, começa com o card vazio. Se nenhum dos três campos estiver preenchido, o **Enviar teste** avisa para configurar o destinatário antes.

## Mensagens arquivadas

As conversas não ficam para sempre no painel. Mensagens com mais tempo que o **prazo de guarda do seu plano** (12 meses, por padrão) saem das conversas e passam a ficar disponíveis para download, um arquivo por mês.

* **Todo dia**, de madrugada, a plataforma arquiva os meses que passaram do prazo. O arquivamento é por mês inteiro: o mês só é arquivado depois que **todo ele** passou do prazo.
* **O que entra:** conversas de todos os canais (WhatsApp, Instagram, Messenger, TikTok, Telegram e chat do site), grupos de WhatsApp, grupos de Telegram e o histórico do chatbot.
* **O que não entra:** imagens, áudios, vídeos e outros arquivos. Eles são apagados junto com as mensagens; no arquivo aparecem como `[imagem]`, `[áudio]` e assim por diante, com a legenda quando existir. Os registros de envio de [Logs de mensagens](https://docs.octasend.com.br/plataforma/logs-de-mensagens.md) não são afetados.
* **A conversa continua existindo.** Só as mensagens antigas saem dela.

Para baixar, abra **Conversas** e clique em **Mensagens arquivadas** (no topo da página). A tabela lista um mês por linha, com o total de mensagens, o detalhe por tipo e o tamanho. Clique em **Baixar** para receber um arquivo `.zip` com:

| Arquivo | Conteúdo |
| - | - |
| `conversas.csv` | Mensagens das conversas, com data e hora, canal, conta, contato, direção, autor, tipo, texto e status |
| `grupos.csv` | Mensagens dos grupos de WhatsApp |
| `grupos_telegram.csv` | Mensagens dos grupos de Telegram |
| `chatbot.csv` | Mensagens do histórico do chatbot |
| `LEIA-ME.txt` | Período, quantidades e o aviso de que a mídia foi removida |

Os CSV abrem direto no Excel e usam ponto e vírgula como separador.

> [!NOTE]
>
> Só quem tem a permissão **Baixar mensagens arquivadas** vê o botão e a tela. Por padrão, é o usuário MASTER. Se você precisa que outra pessoa baixe, libere no perfil de acesso dela. O prazo de guarda é definido no plano: para mudar o prazo da sua conta, fale com a OctaSend.

## OAuth Clients

Em **Configurações → OAuth Clients** você cria as credenciais que o seu servidor usa para chamar a API da OctaSend. É a única forma de autenticar na API — o passo a passo de uso está em [Autenticação](https://docs.octasend.com.br/api-reference/autenticacao.md).

**1. Dê um nome ao client**

Por exemplo, "Loja Virtual – Produção". O nome é obrigatório.

**2. Clique em Criar**

A tela mostra o `client_id` e o `client_secret`, cada um com botão de copiar.

**3. Guarde o client\_secret agora**

Ele é exibido uma única vez. Depois de fechar o aviso, não há como vê-lo de novo — se perder, revogue e crie outro client.

A lista mostra **Nome**, `client_id`, **Escopos** (hoje, `send`), **Último uso** e **Status**.

**Revogar** pede confirmação e tem efeito imediato: o client passa a **Inativo** e todos os access tokens emitidos para ele deixam de valer na hora. Um client revogado não pode ser reativado.

Abaixo da lista, a própria tela traz uma referência da API com exemplos em cURL, JavaScript, PHP e Python. Os detalhes estão em [Enviar mensagens](https://docs.octasend.com.br/api-reference/enviar-mensagens.md) e [Consultar logs](https://docs.octasend.com.br/api-reference/consultar-logs.md).

## MCP Server

Em **Configurações → MCP Server** fica o passo a passo para conectar o Claude Code à sua conta: o comando pronto, o arquivo de configuração e um prompt para copiar e colar. A conexão usa as mesmas credenciais de **OAuth Clients**. Veja [MCP Server](https://docs.octasend.com.br/api-reference/mcp-server.md).

## Assinatura e planos

Em **Configurações → Assinatura** você vê os planos, o plano atual e contrata ou cancela. Os planos são **Free**, **Silver** e **Gold**; cada card mostra a descrição, o preço mensal em reais (ou **Grátis**) e os recursos incluídos. O plano em uso tem a marca **Plano atual**, e o botão dele fica desabilitado.

O botão de cada card diz o que acontece:

| Card | Botão |
| - | - |
| Plano pago mais caro que o atual | **Mudar para** e o nome do plano (ex.: **Mudar para Gold**) |
| Plano pago mais barato que o atual | **Voltar para** e o nome do plano (ex.: **Voltar para Silver**) |
| **Free**, quando você está num plano pago | **Cancelar assinatura** |

> [!NOTE]
>
> Só usuários **MASTER** da conta em uso assinam, trocam ou cancelam o plano. Para um usuário **PADRÃO**, a tela mostra os planos com os botões desabilitados e o aviso **Só o usuário master da conta pode alterar a assinatura**, pedindo a um usuário master desta conta para fazer a alteração.

### Contratar ou trocar de plano

**1. Escolha o plano**

No card do plano pago que você quer, clique em **Mudar para** (ou **Voltar para**) e o nome do plano.

**2. Preencha o pagamento**

O formulário **Finalizar pagamento** abre na própria tela. Para desistir, use **Voltar aos planos**.

**3. Clique em Confirmar pagamento**

Com o pagamento confirmado, o plano passa a valer e a tela volta para a lista de planos.

Para trocar de um plano pago para outro, selecione o novo plano e conclua o pagamento:

* O plano atual continua ativo, e cobrando, até o pagamento do plano novo ser confirmado.
* Com o pagamento confirmado, o plano novo passa a valer e as assinaturas anteriores da conta que ainda poderiam cobrar são canceladas automaticamente, inclusive uma que você começou em outro plano e não chegou a pagar.
* Se você desistir no formulário, ou o pagamento for recusado, nada muda na conta: o plano atual segue valendo.
* Não há cobrança proporcional: os dias já pagos do plano anterior não viram crédito no novo.

Quando o pagamento on-line está indisponível, a tela mostra o aviso **Pagamento indisponível** e os botões dos planos pagos ficam desabilitados.

### Status da assinatura

No card do plano atual (quando é pago), logo abaixo do preço, aparece o status:

| Status | Significado |
| - | - |
| **Ativo** | Assinatura em dia |
| **Pagamento atrasado** | A cobrança da assinatura não foi paga |
| **Incompleto** | A assinatura foi iniciada, mas o primeiro pagamento ainda não foi confirmado |
| **Cancelado** | A assinatura foi encerrada |

### O que muda com o plano

| | Free | Silver | Gold |
| - | - | - | - |
| Canais liberados | E-mail e WhatsApp | E-mail e WhatsApp | E-mail, WhatsApp, Telegram, Slack, Web push, In-app e SMS |
| Menu **Campanhas** | Não | Não | Sim |

Esses são os canais liberados por padrão para cada plano; a OctaSend pode ajustar a liberação da sua conta. Só os canais liberados aparecem em **Configurações → Canais**.

### Cancelar

No card do plano **Free**, clique em **Cancelar assinatura** e confirme. O cancelamento é **imediato**: a conta volta na hora para o plano **Free**, e os canais liberados passam a ser apenas E-mail e WhatsApp. O mesmo vale quando a assinatura é encerrada pelo sistema de pagamento.

> [!NOTE]
>
> Contratar, trocar e cancelar o plano são ações só do usuário **MASTER**. Um usuário PADRÃO vê a tela, mas não altera a assinatura.

## Claude Design

Em **Configurações → Claude Design** (tela **Conexão com o Claude Design**) você guarda o **sessionKey** da sua conta do Claude, para importar designs privados do Claude Design nos layouts de e-mail e no [design system](https://docs.octasend.com.br/plataforma/design-system.md). Sem ele, a importação por link lê só designs públicos.

**1. Copie o sessionKey**

Siga os passos de **Como obter o sessionKey**: no navegador em que você está logado no claude.ai, abra as ferramentas do desenvolvedor (F12), vá em **Application → Cookies → [https://claude.ai](https://claude.ai)** e copie o valor da linha `sessionKey`. Ele começa com `sk-ant-sid01-`.

**2. Cole e salve**

Cole o valor em **Valor do sessionKey** e clique em **Salvar sessionKey**. Se o valor não parecer um sessionKey, a tela avisa antes de salvar.

**3. Teste**

Em **Testar a conexão**, cole o link de uma página de layout (do Claude Design ou de qualquer site) e clique em **Testar conexão**. Se a leitura funcionar, aparece **Conexão funcionando: o layout foi lido (N caracteres).**

* Só usuários **MASTER** da conta em uso salvam, trocam (**Substituir**) ou removem (**Remover sessionKey**, com confirmação) o sessionKey. Para os demais, a tela mostra se ele está **Configurado** e o aviso de que só o MASTER pode alterar. O teste de conexão funciona para todos.
* Depois de salvo, o sessionKey fica cifrado e nunca volta ao navegador: o campo mostra só uma máscara.
* Todos os usuários da conta importam designs privados com o sessionKey salvo. Ele dá acesso à conta do Claude de quem o copiou: quando essa pessoa deixar de usar o painel, remova o sessionKey.
* Se um design privado for recusado, a importação mostra **O Claude Design recusou o acesso (sessionKey ausente, invalido ou expirado)**. Salve um sessionKey novo e tente de novo.

## Auditoria

Em **Configurações → Auditoria** (só para quem é **MASTER** na conta em uso) você vê quem criou, editou ou excluiu cadastros da conta, e quando.

A tabela mostra **Cadastro**, **Ação** (**Criado**, **Editado** ou **Excluído**), **Usuário** (o e-mail de quem fez a alteração) e **Data**. Alterações feitas pela própria plataforma, sem um usuário por trás, aparecem como **Sistema**.

Filtros disponíveis:

* **Buscar por e-mail do usuário** — busca por parte do e-mail.
* **Cadastro** — Comunicações, Canais de comunicação, Templates, Usuários, Tokens API, OAuth Clients, Tokens OAuth, Configurações de canal, Configurações da conta, Conta, Campanhas, Contatos ou Listas de contatos.
* **Ação** — Criado, Editado ou Excluído.
* **De** e **Até** — período, com os dias inteiros incluídos. O dia começa e termina à meia-noite no **Fuso horário** da conta.

O contador ao lado dos filtros mostra quantos registros casam com a busca. A lista mostra 50 registros por página, do mais recente para o mais antigo; quando há mais de 50, os controles de paginação abaixo da tabela dão acesso a todos os registros. Se uma página não carregar, a mensagem de erro aparece com a paginação ainda na tela, para você voltar à página anterior. Mudar qualquer filtro volta para a primeira página. Use **Limpar filtros** para voltar à visão completa.

Clicar num registro abre o **Detalhe da alteração**, com cada campo alterado e os valores antes e depois. Valores sensíveis, como segredos e configurações criptografadas, aparecem mascarados (`••••`).

## Chave própria de IA

Os recursos de IA da OctaSend usam, por padrão, a conta de IA da plataforma. Se preferir usar a sua própria conta de um provedor, cadastre a chave em **Chatbot → Chatbot WhatsApp**, abrindo um bot e indo na aba **Configuração do Bot**, na seção **Meu LLM (opcional)**.

**1. Escolha o provedor**

Anthropic (Claude), OpenAI, Grok (xAI) ou DeepSeek.

**2. Escolha o modelo**

O modelo escolhido vale para aquele bot.

**3. Cole a chave de API e clique em Salvar token**

Depois de salva, a chave aparece mascarada, só com os 4 últimos caracteres.

Como a chave funciona:

* A chave é da **conta**, não do bot: existe uma por provedor. Qualquer recurso de IA da OctaSend que use aquele provedor passa a usar a sua chave. O provedor de cada recurso é definido pela OctaSend, com exceção do chatbot, em que você escolhe provedor e modelo.
* Com uma chave cadastrada, aparece o card **Meu limite de tokens**, que mostra o **consumo atual** feito com a sua chave e permite definir um **Limite de tokens (opcional)**. Em branco, não há teto. Quando o consumo atinge o limite, os recursos de IA que usariam a sua chave deixam de ser executados.
* O limite vale só para as chamadas feitas com a sua chave; o uso da conta da plataforma segue as regras da OctaSend.

> [!NOTE]
>
> A configuração do bot só abre com o **Módulo de chatbot** ativado, na lista de bots em **Chatbot → Chatbot WhatsApp**. Veja [Chatbot com IA](https://docs.octasend.com.br/plataforma/chatbot.md).


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