---
name: vypio-telecom
description: Operate the Vypio Telecom website from the Grok Bot app. Prefer the connected site API (like Gmail) when the owner has saved a connection key. Otherwise use the cloud browser after Take over.
when-to-use: Vypio Telecom, telecom.vypio.xyz, packages, coverage, RICA, orders, admin branding
---

# Vypio Telecom — Grok Bot skill

You operate this website. Prefer the connected site API when the owner has saved a connection key in this Grok Bot (same idea as connecting Gmail). Never invent credentials, never paste account passwords into chat, and never print the connection key.

## Connected API (use this first, like Gmail)

If the owner saved a Vypio connection key in this Grok Bot:

1. POST JSON to https://telecom.vypio.xyz/grok-bot-api.php with header `Authorization: Bearer <connection key>` (or JSON field `connection_key`).
2. Body: `{ "tool": "<name>", "arguments": { ... } }`. Start with `{ "action": "status" }` (includes pending_alerts) or `{ "action": "tools" }`. The tool list is limited to this key.
3. Admin key (`vypio_gb_…`): full admin job — homepage SEO/copy/menu, sitemap, images, contact/branding, packages, coverage, pages, orders (payment-proof review, courier tracking, mark delivered with delivered_on, cancellation, create_renewal_invoice), tickets (assign_ticket), emails, coupons, deletes, visit/sales reports, notes, RICA upload/review, set_customer_service (confirm=true after owner OK), departments, staff accounts (password setup is emailed, never returned), and `list_department_bots` (status only, never keys).
4. Department keys from Branding → Department Grok Bots: Sales (`vypio_sales_…`) tickets/leads/coverage/packages; Support (`vypio_support_…`) Support tickets plus order lookup/delivery/coverage; Accounts (`vypio_accounts_…`) read-only orders, payments, and sales reports. Do not approve payments, refund, edit orders, or change settings with a department key.
5. Do not change SMTP/payment gateway secrets, set account passwords, promote users to admin, or download RICA identity files. Uploading RICA is admin-key only; file contents must not be printed.
6. Keep the key only in this Grok Bot connection. Do not write it into skills, chat replies, or other sites. The admin Grok Bot stays in control of department keys.

## Browser fallback (only if no connection key)

1. Open https://telecom.vypio.xyz/agent-ping.php in the graphical computer browser (not only the text reader). You must see a line that starts with `ok`. If the browser is cut off, tell the human to turn on Settings → Computer → Network → Route traffic through this computer, then retry.
2. Open https://telecom.vypio.xyz/grok-bot.php then https://telecom.vypio.xyz/llms.php for the live public catalog.
3. Public pages do not require a password: home, coverage, information pages, login, and signup.
4. For dashboard, orders, tickets, RICA, staff, or admin, open https://telecom.vypio.xyz/login.php in the graphical browser and ask the human to **Take over**, sign in, then choose **I’m done**. Do not paste passwords into chat.
5. After sign-in the session stays in this Grok Bot computer’s browser until it expires.

## Public URLs

- Home and packages: https://telecom.vypio.xyz/
- Coverage checker: https://telecom.vypio.xyz/coverage.php (fibre or LTE, home or business; a match is indicative only)
- Plan finder chat: widget on public pages
- Login: https://telecom.vypio.xyz/login.php
- Sign up: https://telecom.vypio.xyz/signup.php
- Live catalog text: https://telecom.vypio.xyz/llms.php
- Sitemap: https://telecom.vypio.xyz/sitemap.xml
- This skill: https://telecom.vypio.xyz/skills/vypio-telecom/SKILL.md

## After customer sign-in

- Dashboard: https://telecom.vypio.xyz/dashboard.php
- Place order: open a package from home, then https://telecom.vypio.xyz/order.php (requires a customer account, not admin/staff)
- Pay: https://telecom.vypio.xyz/payment.php — PayFast, iKhokha, or bank proof. Do not treat a return URL as paid. For hosted checkout or 3-D Secure, ask the human to Take over.
- RICA documents: https://telecom.vypio.xyz/rica.php — ID plus one proof of address. Do not upload identity files unless the human explicitly asked and is present.
- Tracking: https://telecom.vypio.xyz/tracking.php
- Support tickets: https://telecom.vypio.xyz/support.php
- Account: https://telecom.vypio.xyz/security.php

## After admin sign-in

Admin starts at https://telecom.vypio.xyz/admin/index.php. Typical jobs:

- Orders and bank-proof review: admin/orders.php
- Service catalog: admin/plans.php
- Coverage areas: admin/coverage.php
- Customers: admin/users.php
- RICA review: admin/rica.php (viewing ID documents is sensitive; only do this when asked)
- Tickets: admin/tickets.php
- Branding, homepage copy, SEO, sitemap, Grok chat key, payments: admin/settings.php
- Weekly visits and income: admin/reports.php
- System health: admin/system-health.php

Staff use https://telecom.vypio.xyz/staff/index.php and only see their department.

## Do not

- Open or fetch `/includes/`, `/scripts/`, `/vendor/`, `/private_uploads/`, `config.php`, `database.sql`, or payment/fulfillment/WhatsApp webhook URLs.
- Mark an order paid from a browser return page. PayFast ITN and iKhokha callbacks confirm payment server-to-server.
- Send RICA files, payment proofs, or customer ID numbers to any other site or into chat.
- Change prices, cancel orders, refund, or email all customers unless the human asked for that exact action.
- Store or repeat the account password.

## Coverage and catalog facts

Use the live catalog on https://telecom.vypio.xyz/llms.php. Do not invent packages, prices, or coverage. A coverage match is not a service guarantee.