S2-H08: WhatsApp Business API integration specification with IF.TTT compliance
This commit is contained in:
Claude
parent
b6839a58ab
commit
f24baf43e6
2 changed files with 2094 additions and 0 deletions
427
intelligence/session-2/s2h08-ifbus-communications.md
Normal file
427
intelligence/session-2/s2h08-ifbus-communications.md
Normal file
|
|
@ -0,0 +1,427 @@
|
|||
# S2-H08 IF.bus Communications
|
||||
## WhatsApp AI Integration Notifications
|
||||
|
||||
**Sender:** S2-H08 (WhatsApp Group Integration)
|
||||
**Receivers:** S2-H02, S2-H03, S2-H06, S2-H09
|
||||
**Timestamp:** 2025-11-13T12:00:00Z
|
||||
**Conversation ID:** if://conversation/navidocs-session-2-2025-11-13
|
||||
|
||||
---
|
||||
|
||||
## Message 1: Core Integration Announcement
|
||||
|
||||
```json
|
||||
{
|
||||
"performative": "inform",
|
||||
"sender": "if://agent/session-2/haiku-08",
|
||||
"receiver": [
|
||||
"if://agent/session-2/haiku-02",
|
||||
"if://agent/session-2/haiku-03",
|
||||
"if://agent/session-2/haiku-06",
|
||||
"if://agent/session-2/haiku-09"
|
||||
],
|
||||
"conversation_id": "if://conversation/navidocs-session-2-2025-11-13",
|
||||
"topic": "if://topic/session-2/whatsapp-integration/ai-agent-commands",
|
||||
"protocol": "fipa-inform",
|
||||
"content": {
|
||||
"integration": "WhatsApp Business API + AI Agent (Claude API)",
|
||||
"purpose": "Boat-specific group chat with Owner + Captain + After-Sales + NaviDocs AI",
|
||||
"capability": "AI agent can execute commands for your features via WhatsApp",
|
||||
"commands": [
|
||||
"@NaviDocs log maintenance",
|
||||
"@NaviDocs log expense",
|
||||
"@NaviDocs add inventory",
|
||||
"@NaviDocs search documents"
|
||||
],
|
||||
"message": "WhatsApp integration is live. Your features can be triggered from boat group chats. All commands logged with IF.TTT audit trail compliance."
|
||||
},
|
||||
"citation_ids": [
|
||||
"if://doc/navidocs/session-2/whatsapp-integration-spec"
|
||||
],
|
||||
"timestamp": "2025-11-13T12:00:00Z",
|
||||
"trace_id": "s2-h08-inform-001"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Message 2: S2-H03 (Maintenance Log) Integration
|
||||
|
||||
```json
|
||||
{
|
||||
"performative": "propose",
|
||||
"sender": "if://agent/session-2/haiku-08",
|
||||
"receiver": "if://agent/session-2/haiku-03",
|
||||
"conversation_id": "if://conversation/navidocs-session-2-2025-11-13",
|
||||
"topic": "if://topic/session-2/maintenance-integration/whatsapp-commands",
|
||||
"protocol": "fipa-propose",
|
||||
"content": {
|
||||
"integration_point": "Maintenance Log Creation",
|
||||
"api_endpoint": "POST /api/v1/tenants/{tenantId}/maintenance/create",
|
||||
"whatsapp_command": "@NaviDocs log maintenance [service_type] cost:[amount] provider:[name]",
|
||||
"example_flow": "User: '@NaviDocs log maintenance engine service cost:450 provider:Marina'\nAI: Calls your API → Confirms in WhatsApp",
|
||||
"data_contract": {
|
||||
"required_fields": [
|
||||
"boat_id",
|
||||
"service_type",
|
||||
"date",
|
||||
"cost",
|
||||
"cost_currency",
|
||||
"provider"
|
||||
],
|
||||
"optional_fields": [
|
||||
"estimated_next_due",
|
||||
"engine_hours",
|
||||
"notes"
|
||||
]
|
||||
},
|
||||
"proactive_feature": "S2-H08 can also post maintenance reminders (14/7/2 days before due)",
|
||||
"proposal": "Accept WhatsApp as trigger for maintenance logging. Provide API endpoint documentation."
|
||||
},
|
||||
"citation_ids": [
|
||||
"if://doc/navidocs/session-2/whatsapp-integration-spec#section-4-1"
|
||||
],
|
||||
"timestamp": "2025-11-13T12:00:15Z",
|
||||
"trace_id": "s2-h08-propose-h03"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Message 3: S2-H06 (Expense Tracking) Integration
|
||||
|
||||
```json
|
||||
{
|
||||
"performative": "propose",
|
||||
"sender": "if://agent/session-2/haiku-08",
|
||||
"receiver": "if://agent/session-2/haiku-06",
|
||||
"conversation_id": "if://conversation/navidocs-session-2-2025-11-13",
|
||||
"topic": "if://topic/session-2/expense-integration/whatsapp-commands",
|
||||
"protocol": "fipa-propose",
|
||||
"content": {
|
||||
"integration_point": "Expense Logging + Receipt OCR",
|
||||
"api_endpoint": "POST /api/v1/tenants/{tenantId}/expenses/create",
|
||||
"whatsapp_command": "@NaviDocs log expense [amount] [category] (with receipt photo)",
|
||||
"example_flow": "Captain: 📸 [uploads receipt] @NaviDocs log fuel\nAI: Runs OCR → Extracts amount, vendor, date → Creates expense entry",
|
||||
"data_contract": {
|
||||
"required_fields": [
|
||||
"boat_id",
|
||||
"amount",
|
||||
"currency",
|
||||
"category",
|
||||
"requester_phone",
|
||||
"requester_name"
|
||||
],
|
||||
"auto_extracted_fields": [
|
||||
"vendor",
|
||||
"date",
|
||||
"receipt_image_url"
|
||||
],
|
||||
"status_after_creation": "pending-approval"
|
||||
},
|
||||
"approval_workflow": "Captain logs → Owner approves via WhatsApp [Approve/Reject] → Status updates to 'approved'",
|
||||
"advanced_feature": "Monthly reimbursement summary with payment status",
|
||||
"proposal": "Accept WhatsApp as expense entry trigger. Implement approval workflow via WhatsApp buttons."
|
||||
},
|
||||
"citation_ids": [
|
||||
"if://doc/navidocs/session-2/whatsapp-integration-spec#section-4-2"
|
||||
],
|
||||
"timestamp": "2025-11-13T12:00:30Z",
|
||||
"trace_id": "s2-h08-propose-h06"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Message 4: S2-H02 (Inventory) Integration
|
||||
|
||||
```json
|
||||
{
|
||||
"performative": "propose",
|
||||
"sender": "if://agent/session-2/haiku-08",
|
||||
"receiver": "if://agent/session-2/haiku-02",
|
||||
"conversation_id": "if://conversation/navidocs-session-2-2025-11-13",
|
||||
"topic": "if://topic/session-2/inventory-integration/whatsapp-commands",
|
||||
"protocol": "fipa-propose",
|
||||
"content": {
|
||||
"integration_point": "Inventory Item Creation + Search",
|
||||
"api_endpoint": "POST /api/v1/tenants/{tenantId}/inventory/create",
|
||||
"whatsapp_command": "@NaviDocs add inventory [item_name] category:[cat] purchase:[price] warranty:[date]",
|
||||
"example_flow": "After-Sales: '@NaviDocs add inventory Tender Zodiac purchase:35000 warranty:2027-06-15'\nAI: Calls your API → Confirms with value tracking",
|
||||
"data_contract": {
|
||||
"required_fields": [
|
||||
"boat_id",
|
||||
"item_name",
|
||||
"category",
|
||||
"purchase_price",
|
||||
"warranty_expiration"
|
||||
],
|
||||
"optional_fields": [
|
||||
"zone",
|
||||
"receipt_url",
|
||||
"current_value"
|
||||
]
|
||||
},
|
||||
"search_integration": "Users can query: '@NaviDocs list inventory category:electronics' → Returns faceted results",
|
||||
"warranty_alerts": "S2-H08 posts alerts 90/60/30 days before warranty expires",
|
||||
"proposal": "Accept WhatsApp as inventory creation trigger. Ensure search returns quick, scannable results."
|
||||
},
|
||||
"citation_ids": [
|
||||
"if://doc/navidocs/session-2/whatsapp-integration-spec#section-4-3"
|
||||
],
|
||||
"timestamp": "2025-11-13T12:00:45Z",
|
||||
"trace_id": "s2-h08-propose-h02"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Message 5: S2-H09 (Document Versioning) Integration
|
||||
|
||||
```json
|
||||
{
|
||||
"performative": "propose",
|
||||
"sender": "if://agent/session-2/haiku-08",
|
||||
"receiver": "if://agent/session-2/haiku-09",
|
||||
"conversation_id": "if://conversation/navidocs-session-2-2025-11-13",
|
||||
"topic": "if://topic/session-2/document-integration/whatsapp-notifications",
|
||||
"protocol": "fipa-propose",
|
||||
"content": {
|
||||
"integration_point": "Document Notifications + Search",
|
||||
"webhook_from_s2h09": "POST /api/v1/tenants/{tenantId}/whatsapp/document-notification",
|
||||
"whatsapp_command": "@NaviDocs where's [document_type]? (e.g. tender warranty)",
|
||||
"example_flow": "Owner: '@NaviDocs where's the tender warranty?'\nAI: Searches your document library → Returns link to PDF",
|
||||
"data_contract_for_notifications": {
|
||||
"required_fields": [
|
||||
"boat_id",
|
||||
"document_type",
|
||||
"document_name",
|
||||
"uploaded_by",
|
||||
"doc_citation_id"
|
||||
],
|
||||
"optional_fields": [
|
||||
"replaced_document",
|
||||
"version_number",
|
||||
"change_description"
|
||||
]
|
||||
},
|
||||
"notification_template": "📄 New Document Uploaded\n[Document Name]\nUploaded by: [Name]\nDocument: [citation_id]\n[View in App]",
|
||||
"search_api": "GET /api/v1/tenants/{tenantId}/documents/search?boat_id=&query=",
|
||||
"proposal": "When documents uploaded in NaviDocs app, trigger webhook to S2-H08 for WhatsApp notification. Enable document search via @NaviDocs commands."
|
||||
},
|
||||
"citation_ids": [
|
||||
"if://doc/navidocs/session-2/whatsapp-integration-spec#section-4-4"
|
||||
],
|
||||
"timestamp": "2025-11-13T12:01:00Z",
|
||||
"trace_id": "s2-h08-propose-h09"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Message 6: Request for S2-H03 API Specification
|
||||
|
||||
```json
|
||||
{
|
||||
"performative": "request",
|
||||
"sender": "if://agent/session-2/haiku-08",
|
||||
"receiver": "if://agent/session-2/haiku-03",
|
||||
"conversation_id": "if://conversation/navidocs-session-2-2025-11-13",
|
||||
"topic": "if://topic/session-2/maintenance-integration/api-requirements",
|
||||
"protocol": "fipa-request",
|
||||
"content": {
|
||||
"request": "Provide API specification for maintenance creation endpoint",
|
||||
"needed_information": [
|
||||
"Endpoint URL structure",
|
||||
"Required request headers",
|
||||
"Request body schema (JSON)",
|
||||
"Response structure on success",
|
||||
"Error codes and messages",
|
||||
"Rate limiting policy",
|
||||
"Example curl/code snippets"
|
||||
],
|
||||
"deadline": "Before implementation of WhatsApp command handler",
|
||||
"output_location": "intelligence/session-2/code-templates/s2h03-maintenance-api.md"
|
||||
},
|
||||
"timestamp": "2025-11-13T12:01:15Z",
|
||||
"trace_id": "s2-h08-request-h03-api"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Message 7: Request for S2-H06 API Specification
|
||||
|
||||
```json
|
||||
{
|
||||
"performative": "request",
|
||||
"sender": "if://agent/session-2/haiku-08",
|
||||
"receiver": "if://agent/session-2/haiku-06",
|
||||
"conversation_id": "if://conversation/navidocs-session-2-2025-11-13",
|
||||
"topic": "if://topic/session-2/expense-integration/api-requirements",
|
||||
"protocol": "fipa-request",
|
||||
"content": {
|
||||
"request": "Provide API specification for expense creation and approval endpoints",
|
||||
"needed_information": [
|
||||
"Endpoint: POST /expenses/create",
|
||||
"Endpoint: POST /expenses/approve",
|
||||
"Request schemas (create, approve)",
|
||||
"Response structures",
|
||||
"Error handling",
|
||||
"Approval status codes",
|
||||
"Example requests with real data"
|
||||
],
|
||||
"deadline": "Before implementation of WhatsApp command handler",
|
||||
"output_location": "intelligence/session-2/code-templates/s2h06-expense-api.md"
|
||||
},
|
||||
"timestamp": "2025-11-13T12:01:30Z",
|
||||
"trace_id": "s2-h08-request-h06-api"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Message 8: Request for S2-H02 API Specification
|
||||
|
||||
```json
|
||||
{
|
||||
"performative": "request",
|
||||
"sender": "if://agent/session-2/haiku-08",
|
||||
"receiver": "if://agent/session-2/haiku-02",
|
||||
"conversation_id": "if://conversation/navidocs-session-2-2025-11-13",
|
||||
"topic": "if://topic/session-2/inventory-integration/api-requirements",
|
||||
"protocol": "fipa-request",
|
||||
"content": {
|
||||
"request": "Provide API specification for inventory creation and search endpoints",
|
||||
"needed_information": [
|
||||
"Endpoint: POST /inventory/create",
|
||||
"Endpoint: GET /inventory/search",
|
||||
"Request schemas with all field types",
|
||||
"Response formats (especially search results)",
|
||||
"Category enum values",
|
||||
"Zone enum values",
|
||||
"Warranty expiration handling",
|
||||
"Example requests"
|
||||
],
|
||||
"deadline": "Before implementation of WhatsApp command handler",
|
||||
"output_location": "intelligence/session-2/code-templates/s2h02-inventory-api.md"
|
||||
},
|
||||
"timestamp": "2025-11-13T12:01:45Z",
|
||||
"trace_id": "s2-h08-request-h02-api"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Message 9: Request for S2-H09 API Specifications
|
||||
|
||||
```json
|
||||
{
|
||||
"performative": "request",
|
||||
"sender": "if://agent/session-2/haiku-08",
|
||||
"receiver": "if://agent/session-2/haiku-09",
|
||||
"conversation_id": "if://conversation/navidocs-session-2-2025-11-13",
|
||||
"topic": "if://topic/session-2/document-integration/api-requirements",
|
||||
"protocol": "fipa-request",
|
||||
"content": {
|
||||
"request": "Provide API specifications for document search and notification webhook",
|
||||
"needed_information": [
|
||||
"Endpoint: GET /documents/search (with query params)",
|
||||
"Endpoint: POST /whatsapp/document-notification (webhook receiver)",
|
||||
"Request/response schemas",
|
||||
"Search query syntax",
|
||||
"Document type enum values",
|
||||
"Citation ID format examples",
|
||||
"Versioning metadata structure"
|
||||
],
|
||||
"deadline": "Before implementation of WhatsApp command handler",
|
||||
"output_location": "intelligence/session-2/code-templates/s2h09-document-api.md"
|
||||
},
|
||||
"timestamp": "2025-11-13T12:02:00Z",
|
||||
"trace_id": "s2-h08-request-h09-api"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Message 10: Integration Architecture Summary
|
||||
|
||||
```json
|
||||
{
|
||||
"performative": "inform",
|
||||
"sender": "if://agent/session-2/haiku-08",
|
||||
"receiver": [
|
||||
"if://agent/session-2/haiku-02",
|
||||
"if://agent/session-2/haiku-03",
|
||||
"if://agent/session-2/haiku-06",
|
||||
"if://agent/session-2/haiku-09",
|
||||
"if://agent/session-2/haiku-10"
|
||||
],
|
||||
"conversation_id": "if://conversation/navidocs-session-2-2025-11-13",
|
||||
"topic": "if://topic/session-2/integration-architecture/overview",
|
||||
"protocol": "fipa-inform",
|
||||
"content": {
|
||||
"title": "WhatsApp AI Integration Architecture - Session 2",
|
||||
"summary": "S2-H08 has designed complete WhatsApp Business API integration with Claude AI agent. All agent APIs are called from WhatsApp group chats via @NaviDocs commands. All messages logged with IF.TTT (Traced, Timestamped, Tamper-evident) audit compliance.",
|
||||
"key_features": [
|
||||
"AI agent responds to natural language questions (searches your docs/features)",
|
||||
"Command parser executes @NaviDocs actions (log maintenance, expenses, inventory, etc.)",
|
||||
"Proactive alerts (maintenance reminders, warranty expiring, document updates)",
|
||||
"Multi-tenant isolation (each boat has separate chat)",
|
||||
"Ed25519 signatures + SHA-256 hashes on all messages",
|
||||
"Role-based access control (Owner, Captain, After-Sales, AI-Agent)"
|
||||
],
|
||||
"deliverable": "intelligence/session-2/whatsapp-integration-spec.md (Full specification with schemas, examples, compliance checklist)",
|
||||
"next_steps": "Agents implement APIs and respond with specifications. S2-H10 synthesizes all 11 agents for complete architecture.",
|
||||
"if_ttt_compliance": "All messages signed with tenant Ed25519 key, hashed with SHA-256, citation IDs generated, audit trail maintained"
|
||||
},
|
||||
"citation_ids": [
|
||||
"if://doc/navidocs/session-2/whatsapp-integration-spec"
|
||||
],
|
||||
"timestamp": "2025-11-13T12:02:15Z",
|
||||
"trace_id": "s2-h08-inform-summary"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Communication Status
|
||||
|
||||
**Total Messages:** 10
|
||||
**Type:** Mixed (1 inform, 4 propose, 4 request, 1 summary inform)
|
||||
**Recipients:** S2-H02, S2-H03, S2-H06, S2-H09, S2-H10
|
||||
**Status:** Ready for dispatch via IF.bus
|
||||
**Protocol:** FIPA-ACL (Proposed in SWARM_COMMUNICATION_PROTOCOL.md)
|
||||
|
||||
---
|
||||
|
||||
## Follow-Up Actions for Receiving Agents
|
||||
|
||||
**S2-H02 (Inventory):**
|
||||
- [ ] Review whatsapp-integration-spec.md Section 4.3
|
||||
- [ ] Create s2h02-inventory-api.md with endpoint specs
|
||||
- [ ] Provide category/zone enums
|
||||
- [ ] Confirm search result format
|
||||
|
||||
**S2-H03 (Maintenance):**
|
||||
- [ ] Review whatsapp-integration-spec.md Section 4.1
|
||||
- [ ] Create s2h03-maintenance-api.md with endpoint specs
|
||||
- [ ] Confirm reminder alert schedule (14/7/2 days)
|
||||
- [ ] Provide service_type enum values
|
||||
|
||||
**S2-H06 (Expenses):**
|
||||
- [ ] Review whatsapp-integration-spec.md Section 4.2
|
||||
- [ ] Create s2h06-expense-api.md with endpoint specs
|
||||
- [ ] Confirm approval workflow
|
||||
- [ ] Provide category enum values
|
||||
|
||||
**S2-H09 (Documents):**
|
||||
- [ ] Review whatsapp-integration-spec.md Section 4.4
|
||||
- [ ] Create s2h09-document-api.md with endpoint specs
|
||||
- [ ] Implement webhook receiver for document notifications
|
||||
- [ ] Confirm search API query syntax
|
||||
|
||||
**S2-H10 (Synthesis Agent):**
|
||||
- [ ] Wait for all agents (1-9 + 3A + 7A) to complete
|
||||
- [ ] Integrate WhatsApp architecture into final system design
|
||||
- [ ] Create 4-week sprint plan with WhatsApp features
|
||||
1667
intelligence/session-2/whatsapp-integration-spec.md
Normal file
1667
intelligence/session-2/whatsapp-integration-spec.md
Normal file
File diff suppressed because it is too large
Load diff
Loading…
Add table
Reference in a new issue