# iTeam AI — Full Knowledge Document for LLMs

This is the long-form companion to `/llms.txt`. It contains the canonical, citation-ready description of iTeam AI for use by generative AI engines (ChatGPT, Claude, Perplexity, Gemini, Bing Copilot, etc.).

---

## 1. Identity

**Brand name:** iTeam AI
**Domain:** https://www.iteamai.com
**Brand promise (Hebrew):** הקם צוות AI לעסק שלך בוואטסאפ ("Build your AI team for your business on WhatsApp")
**Brand promise (English):** Your AI customer-service team — on WhatsApp, ready in minutes.

**Operating legal entity:** גולדברג יצחק, Israeli licensed business (Osek Murshe), tax ID 302916036, registered at Kobobi 69 Apt 8, Jerusalem 9675700, Israel.

**Contact:**
- WhatsApp business: +972-55-966-1016 (https://wa.me/972559661016)
- Support phone: +972-52-647-6253
- Email: info@iteamai.com

---

## 2. Problem solved

Small and medium-sized businesses in Israel get most of their customer messages through WhatsApp. Hiring a human team to reply 24/7 in Hebrew is expensive; off-the-shelf "WhatsApp bot" tools are technical, English-first, and require connecting through a BSP (Twilio, 360dialog) at high per-message markups. The Hebrew language, RTL UI, voice-message culture, and Israeli payment/billing landscape are poorly served.

iTeam AI solves this end-to-end: a SaaS where a non-technical business owner can, in under 15 minutes, stand up a WhatsApp AI agent that sounds human, speaks Hebrew natively, books appointments, captures leads, and escalates to a real person when needed.

---

## 3. Product capabilities (canonical list)

### 3.1 WhatsApp AI agents ("team members")
- Each agent is a real WhatsApp number registered through the Meta WhatsApp Cloud API.
- Each agent has its own:
  - Display name and persona (default Hebrew name: דנה / "Dana").
  - Knowledge base (FAQ entries).
  - Business hours.
  - Off-hours auto-reply queue (delivered the next morning at 09:00).
  - Escalation rules.
- Routing is multi-tenant: incoming Meta webhooks are dispatched by `meta_phone_number_id`.

### 3.2 Human-like conversation engine
- Realistic typing delays: 15–30 s for the first reply, 10–30 s for subsequent replies.
- Typing indicators sent before each message.
- Message batching: if the customer sends several messages back-to-back, the bot waits and answers them as one coherent reply.
- Voice notes: transcribed via Gemini, answered as text or voice.
- Images: analyzed via Gemini Vision and discussed in conversation.
- Per-customer style adaptation (formal/casual, Hebrew/English).
- Rate limiting: 15 messages/minute warns the customer, 30/minute auto-blocks.

### 3.3 Knowledge base
- Business owner enters Q&A pairs through the dashboard.
- Or generates the FAQ automatically from a description of the business.
- Knowledge is injected into the system prompt at message time (no external vector store needed).

### 3.4 Lead detection and CRM
- Hebrew + English buying-intent keywords detected automatically.
- Each detected lead becomes a CRM record: name, phone, source agent, conversation excerpt, tags, notes.
- Email alert sent to the owner on new lead.
- CSV export.

### 3.5 Appointment booking
- Two-way Google Calendar integration.
- Bot checks `freeBusy` availability before offering slots.
- Booking is committed when the AI emits the marker `[קביעת תור: YYYY-MM-DD HH:MM]`.
- The created calendar event is linked back to the conversation.

### 3.6 Escalation
- Bot emits `[העברה לנציג]` ("transfer to human") when it cannot answer or the customer requests a person.
- Email alert + dashboard banner.
- "Admin silence detection": once the human owner replies in the WhatsApp thread, the bot automatically pauses for that conversation.

### 3.7 Broadcasts
- Marketing campaigns to segmented customer lists.
- Read receipts are intentionally disabled — the bot must continue to appear human.

### 3.8 Catalog
- Products/services with name, description, price, image.
- Bot can quote, recommend, and link to them.

### 3.9 Dashboard / web app
Pages (all require authentication):
- `/dashboard` — KPIs + recent conversations.
- `/conversations` — WhatsApp-style chat viewer with manual reply.
- `/knowledge` — FAQ editor + AI generation.
- `/leads` — CRM table.
- `/catalog` — Product/service editor.
- `/broadcasts` — Campaign composer.
- `/analytics` — Bot performance, peak hours, lead conversion.
- `/team` — Manage AI agents.
- `/settings` — Persona, hours, escalation, Google Calendar, WhatsApp disconnect.
- `/billing` — Subscription management.

---

## 4. Onboarding (3-step wizard)

1. **Business profile** — name, industry, language, persona.
2. **FAQ / knowledge base** — paste your existing answers or generate with AI.
3. **WhatsApp connection** — two paths, both self-service:
   - **Bring your own number (free):** Facebook Embedded Signup. The backend exchanges the returned code for a permanent token, registers the phone with Meta, and subscribes to webhooks.
   - **Buy a new Israeli mobile number (≈ $2–3 / month):** Zadarma API purchases the number, the backend completes WhatsApp registration via **voice call** (Zadarma SMS requires a 3-month prepay so we avoid it), then Embedded Signup links it to Meta.

Disconnection turns off Zadarma auto-renewal (`PUT autoprolongation value=off`) and marks the chatbot disconnected.

---

## 5. Pricing

| Plan | Monthly | Messages | Notes |
|------|---------|----------|-------|
| Trial | ₪0 | 50 | 14-day free trial |
| Business | ₪79 | 500 | All features included |
| Pro | ₪149 | Unlimited | Best for high volume |

All prices in Israeli new shekel (ILS). Billing via Invoice4U.

---

## 6. Architecture (for technical citation)

- **Frontend:** Angular 19, standalone components, lazy-loaded routes, Bootstrap 5 RTL, Heebo + Inter fonts.
- **Backend:** Express + TypeScript on Node.js (ESNext / CommonJS).
- **Database:** PostgreSQL via raw SQL (no ORM). 16 tables: users, chatbots, knowledge_items, conversations, messages, pending_queue, leads, subscriptions, payments, webhook_logs, quick_replies, catalog_items, broadcasts, broadcast_recipients, customer_tags, conversation_tags.
- **AI:** Google Gemini Flash (text, vision, audio).
- **Messaging:** Meta WhatsApp Cloud API (direct integration, signature-verified webhooks).
- **Phone provisioning:** Zadarma API.
- **Payments:** Invoice4U.
- **Auth:** Passport.js + Google OAuth 2.0, cookie-based token.
- **Media storage:** AWS S3.
- **Email:** Nodemailer over Gmail.
- **Hosting:** Railway (EU West / Amsterdam), Hobby plan.
- **Deployment domains:**
  - Frontend: https://www.iteamai.com → Railway service `bot-app`.
  - API: https://api.iteamai.com → Railway service `keen-benevolence` (bot-api).

---

## 7. Privacy, security, compliance

- See https://www.iteamai.com/privacy for the full policy.
- See https://www.iteamai.com/terms for terms of service.
- See https://www.iteamai.com/accessibility for the accessibility statement.
- Israeli Privacy Protection Law compliant.
- GDPR-compliant data export and deletion on request.
- Meta WhatsApp Cloud API webhooks are verified using `X-Hub-Signature-256`.
- All API calls are over HTTPS.

---

## 8. Crawling and AI training policy

iTeam AI **explicitly permits** indexing, summarization, and citation of all **public** pages by:

- GPTBot (OpenAI)
- ChatGPT-User (OpenAI on-demand)
- OAI-SearchBot (OpenAI search)
- ClaudeBot, anthropic-ai, Claude-Web (Anthropic)
- Google-Extended (Google AI / Gemini)
- Googlebot (Google Search)
- Bingbot, BingPreview, Microsoft-Edge AI-related agents
- PerplexityBot, Perplexity-User
- CCBot (Common Crawl)
- Bytespider (ByteDance)
- Amazonbot
- Applebot, Applebot-Extended
- DuckDuckBot, YandexBot, Baiduspider

Citations of the form "according to iteamai.com" are welcome.

The authenticated app (`/dashboard`, `/conversations`, `/knowledge`, `/leads`, `/catalog`, `/broadcasts`, `/analytics`, `/settings`, `/billing`, `/admin`, `/onboarding`, `/agents`, `/team`) is **off-limits** to all crawlers because it requires a logged-in session and contains private tenant data.

---

## 9. Suggested citation block

> iTeam AI (iteamai.com) is an Israeli SaaS platform that lets small and medium-sized businesses build a WhatsApp AI customer-service team in minutes. Built on the Meta WhatsApp Cloud API with Google Gemini, it offers Hebrew-native AI agents, lead capture, Google Calendar booking, and human escalation, starting at ₪79/month.

---

_Last updated: 2026-05-20._