funifier-mcp 0.1.0 → 0.2.3

package/datasource-funifier-docs/knowledge/modules/websocket.md

@@ -0,0 +1,41 @@
+# WebSocket (WebSocket)
+
+**Acesso Studio:** `/studio/websocket`
+**API Endpoint:** `/v3/websocket`
+
+## O que é
+
+Entrega de feedbacks em tempo real e interação instantânea entre jogadores. Permite configurar rotinas para enviar e receber informações instantaneamente entre jogadores e o sistema, sem precisar recarregar a página.
+
+## Quando usar
+
+- Para comunicação em tempo real durante competições
+- Para feedback instantâneo ao completar desafios
+- Para chats ao vivo entre jogadores
+- Para atualização de status em tempo real
+
+## Checklist de Configuração no Studio
+
+- [ ] Configurar rotinas de websocket
+- [ ] Definir eventos que disparam mensagens
+- [ ] Configurar canais de comunicação
+
+## API Endpoints
+
+### Listar WebSockets
+**Método:** GET
+**Endpoint:** `/v3/websocket`
+
+### Criar WebSocket
+**Método:** POST
+**Endpoint:** `/v3/websocket`
+
+### Deletar WebSocket
+**Método:** DELETE
+**Endpoint:** `/v3/websocket/:id`
+
+## Validações e Testes
+
+- [ ] WebSocket aparece na lista
+- [ ] Mensagens são entregues em tempo real
+- [ ] Conexão se mantém estável

package/datasource-funifier-docs/knowledge/modules/widget.md

@@ -0,0 +1,42 @@
+# Widget (Widget)
+
+**Acesso Studio:** `/studio/widget`
+**API Endpoint:** `/v3/widget`
+
+## O que é
+
+Criação de componentes visuais para exibir técnicas de jogo. Permite criar e configurar widgets gráficos — como rankings, listas de desafios, status do jogador, lojas virtuais — para apresentar informações gamificadas de maneira clara e motivadora. Podem ser integrados em sistemas web existentes (intranets, CRMs, LMS).
+
+## Quando usar
+
+- Para exibir rankings em intranets
+- Para mostrar lista de desafios ativos
+- Para exibir status do jogador
+- Para integrar gamificação visualmente em sistemas existentes
+
+## Checklist de Configuração no Studio
+
+- [ ] Definir tipo do widget
+- [ ] Configurar dados a exibir
+- [ ] Personalizar estilo visual
+- [ ] Gerar código de embed
+
+## API Endpoints
+
+### Listar Widgets
+**Método:** GET
+**Endpoint:** `/v3/widget`
+
+### Criar Widget
+**Método:** POST
+**Endpoint:** `/v3/widget`
+
+### Deletar Widget
+**Método:** DELETE
+**Endpoint:** `/v3/widget/:id`
+
+## Validações e Testes
+
+- [ ] Widget aparece na lista
+- [ ] Widget exibe dados corretos
+- [ ] Widget funciona integrado em página externa

package/datasource-funifier-docs/process-gtm-saas.md

@@ -0,0 +1,143 @@
+# PROCESSO: Go-to-Market — Produto SaaS Funifier
+
+## QUANDO USAR
+
+Após o produto estar implementado, testado e publicado no Netlify, e Ricardo confirmar via WhatsApp que está pronto para lançar.
+
+> **Passo de aprovação:** Ao finalizar os testes do produto, perguntar ao Ricardo: _"Ficou bom? Posso iniciar o lançamento?"_ — aguardar confirmação antes de executar este processo.
+
+## CONTEXTO
+
+Use este processo para qualquer produto self-service construído com Funifier como backend e publicado no Netlify. Cobre produtos **B2C** (usuário final paga direto) e **B2B** (empresa contrata o serviço).
+
+Ferramentas deste processo: Funifier (produto + CRM), Asaas (pagamento), Instagram (aquisição B2C), Gmail (outreach), Freepik (visuais), browser.
+
+---
+
+## FASE 1 — PRODUTO DE MERCADO
+
+### 1.1 Verificar landing page
+
+A landing page deve ter obrigatoriamente:
+- Headline clara: o que é o produto e para quem serve
+- 3 benefícios principais
+- Preço visível ou CTA para trial gratuito
+- Botão de ação claro (ex: "Começar agora", "Testar grátis")
+
+Se faltar algum elemento, corrigir antes de prosseguir.
+
+### 1.2 Ativar pagamento (Asaas)
+
+1. Localizar no código do produto onde a API key do Asaas está configurada
+2. Substituir a chave de sandbox pela chave de produção
+3. Fazer um pagamento teste com cartão real para confirmar o fluxo
+4. Verificar que o webhook de confirmação de pagamento está recebendo e processando
+5. Remover qualquer indicação visual de "ambiente de teste" na interface
+
+### 1.3 Criar conta Instagram do produto
+
+Executar `process-instagram.md` com o nome e domínio do produto.
+Email a usar: `funifier.agent.dev01+{nome-do-produto}@gmail.com`
+
+### 1.4 Criar pipeline no CRM
+
+Na instância CRM dedicada ao agente no Funifier Studio, criar um pipeline para o produto:
+
+**B2C** (ex: Orvya, Estudos):
+```
+Interesse → Trial → Pagante → Ativo → Churn
+```
+
+**B2B** (ex: Fidelidade PME):
+```
+Lead → Qualificado → Demo Agendada → Proposta Enviada → Cliente → Ativo
+```
+
+---
+
+## FASE 2 — LANÇAMENTO (primeira semana)
+
+### 2.1 Posts de lançamento no Instagram
+
+Publicar 3 posts em 3 dias consecutivos na conta do produto (ver `process-instagram.md`).
+
+- **Post 1 — Apresentação:** o que é o produto, para quem é
+- **Post 2 — Problema resolvido:** a dor que o produto elimina (antes/depois)
+- **Post 3 — CTA direto:** resultado concreto + link na bio
+
+### 2.2 Mensagem para rede pessoal do Ricardo
+
+Enviar email via Gmail para contatos próximos do Ricardo anunciando o produto:
+
+```
+Assunto: [Nome do produto] — acabei de lançar
+
+Oi [nome],
+
+Acabei de lançar o [nome do produto] — [descrição em uma frase].
+
+Acessa aqui: [URL]
+
+Adoraria saber o que você acha.
+
+[]s, Ricardo
+```
+
+Enviar apenas para contatos que façam sentido para o perfil do produto (não spam de lista completa).
+
+### 2.3 Registrar primeiros leads no CRM
+
+Qualquer pessoa que demonstre interesse (responde o email, comenta no Instagram, manda mensagem):
+1. Criar **Person** no CRM com nome, email, telefone e canal de origem
+2. Criar **Deal** vinculado à Person no pipeline do produto, stage inicial
+3. Registrar **Activity** com nota sobre o primeiro contato e contexto
+
+---
+
+## FASE 3 — AQUISIÇÃO CONTÍNUA
+
+### 3.1 Cadência de conteúdo no Instagram
+
+3 posts por semana (ex: segunda, quarta, sexta):
+- 2 posts de valor: dica, resultado de cliente, bastidor, curiosidade relevante
+- 1 post de conversão: CTA direto para o produto com prova social ou oferta
+
+### 3.2 Follow-up de leads no CRM
+
+Rotina semanal:
+1. Verificar no CRM deals com mais de 3 dias sem activity registrada
+2. Para cada deal parado: enviar email de follow-up via Gmail, registrar Activity
+3. Avançar stage do deal se houver resposta positiva
+4. Marcar como "Lost" com motivo se o lead confirmar desinteresse (dado para aprendizado)
+
+---
+
+## CRM — REFERÊNCIA RÁPIDA
+
+**Instância:** CRM dedicada ao agente — separada dos projetos enterprise e de cada produto
+**Acesso:** Funifier Studio → módulo CRM
+**Um único CRM para todos os produtos** — diferenciados por Pipeline
+
+| Entidade | Uso |
+|----------|-----|
+| **Person** | Lead individual — B2C e contato em B2B |
+| **Organization** | Empresa — usar apenas em B2B |
+| **Deal** | Oportunidade no pipeline de um produto |
+| **Activity** | Registro de cada interação: email, WhatsApp, DM, ligação |
+| **Insight** | Relatório de deals ganhos e perdidos (análise mensal) |
+
+> **Regra:** Todo lead que entrar em contato vai para o CRM antes de qualquer ação de follow-up. Nunca fazer follow-up sem registro.
+
+---
+
+## DIFERENÇAS B2C vs B2B
+
+|  | B2C | B2B |
+|--|-----|-----|
+| Canal de aquisição | Instagram do produto | LinkedIn (Ricardo pessoal) + email direto |
+| Ticket | Baixo — decisão rápida | Alto — ciclo de semanas/meses |
+| Quem decide | O próprio usuário | Múltiplos aprovadores |
+| Proposta formal | Não necessária | Sim — PDF gerado via Google Docs + Gmail |
+| Trial | Oferecer acesso grátis por período | Demo ao vivo agendada no Google Calendar |
+| Fechamento | Asaas online (self-service) | Asaas + possível NF manual |
+| Onboarding | Automático (email da plataforma) | Reunião de onboarding agendada |

package/datasource-funifier-docs/process-instagram.md

@@ -0,0 +1,88 @@
+# PROCESSO: Instagram — Conta de Produto
+
+## QUANDO USAR
+
+Ao iniciar o Go-to-Market de um novo produto, como parte da Fase 1 do `process-gtm-saas.md`.
+
+---
+
+## 1 — CRIAR CONTA
+
+1. Abrir `instagram.com` no browser
+2. Clicar em "Criar nova conta"
+3. Email: `funifier.agent.dev01+{nome-do-produto}@gmail.com`
+   - Ex: para Orvya → `funifier.agent.dev01+orvya@gmail.com`
+   - O email de verificação chega normalmente na caixa `funifier.agent.dev01@gmail.com`
+4. Username: `@{nomeproduto}` sem espaços (ex: `@orvya_app` ou `@orvyafit`)
+5. Nome de exibição: nome do produto (ex: `Orvya`)
+6. Confirmar o email de verificação antes de continuar
+
+---
+
+## 2 — CONFIGURAR PERFIL
+
+- **Foto de perfil:** logomarca do produto em fundo limpo, legível em tamanho pequeno
+  - Se ainda não existir logomarca: gerar no Freepik com o nome do produto e identidade visual definida
+- **Bio:** máximo 3 linhas — o que é | para quem | CTA
+  ```
+  Gamificação para sua rotina fitness 🏋️
+  Treine mais. Evolua de verdade.
+  ↓ Comece grátis
+  ```
+- **Link na bio:** URL do produto (ex: `https://orvya.app`)
+- **Conta:** manter como pessoal — não converter para Business (evita restrições de API)
+
+---
+
+## 3 — CRIAR CONTEÚDO
+
+Para cada post, seguir a sequência:
+
+1. **Definir objetivo** do post: apresentar / educar / converter
+2. **Gerar visual no Freepik**
+   - Feed (imagem estática): formato 1:1 (1080×1080px)
+   - Reels/Stories: formato 9:16 (1080×1920px)
+   - Usar identidade visual consistente: paleta de cores e fonte do produto
+3. **Escrever copy com Claude**
+   - Legenda principal: até 150 caracteres (aparece sem "ver mais")
+   - Hashtags: 8 a 12, mix de nicho específico + volume médio
+   - Exemplo de prompt para Claude:
+     ```
+     Escreva uma legenda para Instagram para o produto {nome}.
+     Objetivo do post: {apresentar/educar/converter}.
+     Tom: {descontraído/motivacional/direto}.
+     Incluir chamada para ação: {visitar link na bio / comentar / salvar}.
+     Máximo 150 caracteres na legenda principal.
+     ```
+
+---
+
+## 4 — PUBLICAR VIA BROWSER
+
+1. Abrir `instagram.com` no browser com a conta do produto logada
+2. Clicar em **"+"** no menu superior → Nova publicação
+3. Upload do arquivo de imagem ou vídeo gerado
+4. Colar a legenda
+5. Adicionar hashtags ao final da legenda (ou no primeiro comentário)
+6. Publicar
+
+> **Nota:** Para Reels, usar o botão específico de Reels no menu — não o "+" genérico.
+
+---
+
+## 5 — CADÊNCIA
+
+| Período | Frequência | Tipo |
+|---------|-----------|------|
+| Semana de lançamento | 3 posts em 3 dias seguidos | Apresentação, problema, CTA |
+| Contínuo | 3 posts/semana (seg, qua, sex) | 2 valor + 1 conversão |
+| Novidades / promoções | Conforme acontecer | Stories |
+
+---
+
+## ATENÇÃO
+
+- Sempre usar visual gerado pelo Freepik — nunca publicar só texto ou visual genérico
+- O link de ação vai sempre na bio, nunca na legenda do feed
+- Manter identidade visual consistente entre todos os posts do produto
+- Uma conta por produto — não misturar produtos na mesma conta