Anada coaching GBP contextual, hints proactivos e inteligencia competitiva a su plataforma con peticiones JSON simples.
Coaching AVI Solo & Agency : consejos GBP contextuales segun datos reales del perfil
{
"profile_id": 583,
"key": "avi_xxx",
"query": "What should I fix first?",
"lang": "en",
"user_type": "solo",
"intent": "chat"
}
{
"reply": "Your score is 42/100. Priority: publish a post this week (+5 pts), reply to 2 unanswered reviews (+6 pts).",
"lang": "en"
}
{
"profile_id": 610,
"key": "avi_agency_xxx",
"query": "How is my fleet performing?",
"lang": "en",
"user_type": "agency",
"agency_id": 32,
"intent": "chat"
}
{
"reply": "Fleet avg score: 54/100. 6 at-risk clients detected. Predicted score J+7: 58 pts if you publish bulk posts this week.",
"lang": "en"
}
Hint proactivo determinista : sin llamada LLM, respuesta instantanea segun senales del perfil
{
"hint": "Your last GBP post is over 7 days old : publish this week to recover +5 pts.",
"trigger_key": "stale_post",
"lang": "en"
}
Claves trigger : stale_post | avis_sans_reponse | score<40 | guardian | score_gap
curl https://avision.org/api/v1/avi/proactive-hint/583 \ -H "X-AVI-Key: YOUR_API_KEY"
Response:
{
"hint": "Your last GBP post is over 7 days old β publish this week to recover +5 pts.",
"trigger_key": "stale_post",
"urgency": "medium",
"lang": "en"
}
Hint proactivo de flota : detecta clientes en riesgo y los nombra
{
"hint": "6 at-risk clients: Anthony Verrons, Chamane Guerisseuse, Pura Veda Paris : check their score.",
"trigger_key": "clients_at_risk",
"lang": "en"
}
Asistente marketing publico : responde preguntas en landings (sin auth)
{
"query": "How much does Solo cost?",
"lang": "en",
"page_context": "localedge-local"
}
{
"reply": "Solo is $49 one-time. Optional add-ons: Guardian $4.90/mo, Pro $9.90/mo.",
"cta": {"text": "Try Solo free", "url": "/localedge-local/en/"},
"lang": "en"
}
Deteccion de citas NAP : encuentra menciones en directorios locales
{
"profile_id": 583,
"business_name": "My Business",
"city": "London",
"country": "GB",
"lang": "en",
"category": "restaurant"
}
{
"status": "started",
"profile_id": 583
}
Nota : trabajo asincrono. Consulte /citations/detect/status/{profile_id} para resultados.
| Code | Meaning | Action |
|---|---|---|
| 401 | Invalid or missing AVI API key | Check X-AVI-Key header |
| 403 | Credits exhausted | Top up via dashboard or upgrade plan |
| 422 | Missing profile_id or query | Check required fields |
| 429 | Rate limit exceeded | Max 30 requests/min per key |
| 500 | AVI engine error | Retry after 30s |
curl -X POST https://YOUR_AVI_HOST/chat \
-H "X-AVI-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"profile_id":583,"query":"What should I fix first?","lang":"en","user_type":"solo"}'
Expected response (200):
{
"response": "Your last post is 12 days old β publish one this week to recover +5 pts on your GBP score.",
"intent": "score_coach",
"lang": "en",
"credits_used": 1,
"credits_remaining": 49
}
Start free. Scale when you need. No credit card required.