Conectar o DevZap a um assistente de IA

Um assistente de IA, como o Claude, pode consultar a sua conta do DevZap: você pergunta em português quais números estão conectados, quem tem a etiqueta "Cliente" ou o que saiu ontem para um contato, e ele responde com os dados da conta. Quando o plano inclui o envio pelo assistente, ele também manda a mensagem, sempre com um limite por dia.

Por padrão, o assistente não lê as conversas que o número recebe: o DevZap não guarda essas mensagens. Um administrador pode ligar a gravação das recebidas num número, em Números, depois de ler os avisos. Só então o assistente lê as conversas daquele número, e só com a permissão de ler conversas.

Dois jeitos de conectar

• Pelo login, no claude.ai, no Claude Desktop, no Claude Code e no Codex: o assistente abre uma página do DevZap, você entra com o seu usuário e autoriza. Ninguém copia chave.
• Com uma chave de API, no Claude Code, no Cursor e em outros clientes: você cria a chave em Chaves de API e cola na configuração do assistente. O passo a passo está em Chaves de API.

No Claude Code ou no Codex, pelo terminal

No terminal, rode:

npx devzap

Ele adiciona o DevZap ao Claude Code e ao Codex e abre a página do DevZap no navegador: entre com o seu usuário, confira o aplicativo e clique em Autorizar. Depois, pergunte ao assistente: "Como está a minha conta no DevZap?". Para o assistente também enviar mensagens (nos planos que incluem o envio), rode npx devzap --envio.

No claude.ai ou no Claude Desktop, pelo login

1. Abra Customize > Connectors, clique em + Add e depois em Add custom connector.
2. Dê o nome DevZap, cole o endereço do DevZap seguido de /api/v1/mcp e clique em Continue.
3. Em Authentication, escolha Sign in when needed. Em OAuth client, escolha Use Claude's published identity (Recommended).
4. Clique em Add. Abre a página do DevZap: entre com o seu usuário, se pedir.
5. Na página Conectar aplicativo, confira o Endereço do aplicativo (claude.ai) e para onde o acesso vai. Escolha o workspace e clique em Autorizar.
6. Numa conversa nova, peça: "use o conta_status do DevZap".

Só administradores do workspace autorizam. A conexão cria uma chave em Chaves de API, com o nome do aplicativo, por exemplo Claude Code (claude.ai) (OAuth). Ela não conta no limite de chaves do plano, só vale para o assistente e vence em 90 dias; depois disso, o assistente pede o login de novo. Pelo login, o assistente começa só consultando.

Conectar o mesmo assistente de novo troca a chave: a anterior, sua, é revogada na hora. Se quem conectou sair do workspace ou deixar de ser administrador, a chave do assistente dele é revogada.

Com uma chave de API

• Crie uma chave só para o assistente, com um nome que diga para que ela serve, como Claude da equipe. Se o assistente só vai consultar, escolha o tipo de acesso Só consulta: ele lê a conta, mas não consegue enviar nada.
• No claude.ai, faça os passos 1 e 2 acima. Em Authentication, escolha No sign-in. Em Request headers, escolha authorization e cole Bearer (com o espaço) seguido da chave.
• No Claude Code, no Cursor e no Codex, quem desenvolve encontra os comandos no guia de integração.

O ChatGPT ainda não conecta ao DevZap.

O que o assistente faz

• Consulta: números e o estado de cada um, grupos, etiquetas, quem tem cada etiqueta, mensagens enviadas e agendamentos.
• Envio (quando o plano inclui): manda texto, imagem ou documento, põe mensagem na fila e põe ou tira etiqueta. Cada envio fica registrado. Deixe o assistente pedir a sua confirmação antes de cada envio: ele pode errar o destino ou o texto, e mensagem enviada não volta. Uma forma simples de pedir: "escreva o texto e me mostre antes de enviar".

O envio pelo assistente tem um teto de 200 mensagens por dia na conta, que zera à meia-noite. Os envios do seu sistema e do painel não contam nesse teto.

Para tirar o acesso

Revogue a chave do assistente em Chaves de API: a que você criou ou a que o login criou (o nome termina em (OAuth)). Ele perde o acesso na hora, e as outras chaves continuam funcionando.

← Todos os guias