Encontrar amigos que ya usan la app
Compara números de teléfono normalizados con las cuentas de tu backend y muestra "3 de tus contactos ya están aquí" en lugar de una lista de amigos vacía.
Cuándo merece la pena leer los contactos
Invitar a una persona cada vez
El usuario elige un contacto, la app prepara una invitación personal y abre la hoja de compartir. Sin invitaciones masivas ni sorpresas para quien la recibe.
Añadir rápido un cliente o un compañero de equipo
Las apps de CRM, de reservas y de equipos pueden rellenar un registro nuevo a partir de un contacto elegido, en lugar de obligar a los usuarios a volver a escribir nombres y números.
A menudo no lo necesitas
Un simple enlace de invitación a través de la hoja de compartir nativa (shareapp://) no necesita ningún permiso y es el camino más fácil para pasar la revisión. Pide acceso a los contactos solo cuando la búsqueda de coincidencias o la selección aporten valor real.
Prompt para Cursor
Pega esto en Cursor para implementar la parte de la web app. Revisa el resultado, publica y luego prueba dentro de la app WebViewGold.
Prompt para el agente de Cursor
Prompt para el agente de Cursor: Implementa el acceso a contactos para el envoltorio de app WebViewGold. 1) Crea lib/webviewgold/contacts.ts con isWebViewGold() (navigator.userAgent incluye mi token personalizado de WebViewGold), requestPermission(), que navega a requestcontactpermission://, y readContacts(timeoutMs = 5000), que asigna window.contacts = undefined, navega a readcontacts:// y se resuelve con el objeto de nombres a números de teléfono o con null. 2) Añade normalizeNumber() con libphonenumber-js usando el país del usuario. 3) Construye un componente ContactsPicker: explicación, Continuar (permiso), Cargar contactos (lectura), búsqueda, sin preselección, sin Seleccionar todo. 4) Añade un endpoint de servidor que compare hasta 2000 números normalizados con los usuarios, devuelva solo las coincidencias, no guarde ni registre nada y tenga límite de frecuencia. 5) Envía las invitaciones mediante shareapp://message?=TEXT&url=INVITE_URL. 6) Añade tests y documenta las reglas de privacidad en .cursor/rules.
¡Gran trabajo! Nunca tuve que usar código para nada, pero logré trabajar con esto y tener mi App lista. ¡Fácil y rápido! ¡También con gran ayuda de los creadores!
Pide, lee y usa los contactos de forma responsable
Una hora para el código, algo más para los textos de privacidad.
Declara el permiso
Android: añade
android.permission.READ_CONTACTSa AndroidManifest.xml, como exige la documentación de WebViewGold. iOS: la descripción de uso de contactos en Info.plist debe explicar el motivo, por ejemplo "para mostrarte cuáles de tus contactos ya usan la app".Primero explica, luego pide
Muestra una pantalla propia que explique el beneficio, con un botón Continuar, y después navega a
requestcontactpermission://. No lo pidas nunca en el primer inicio ni antes de que el usuario llegue a la función.Lee la agenda
Con el permiso concedido, navega a
readcontacts://. WebViewGold rellena la variable globalcontactscon un objeto de nombres y arrays de números de teléfono; sin permiso, su valor esnull.Deja que el usuario elija
Muestra una lista con búsqueda, sin nada preseleccionado y sin botón Seleccionar todo, y enseña el texto exacto de la invitación antes de enviar nada.
Envía solo lo que la función necesita
Para encontrar amigos, normaliza los números y envíalos a tu backend para una comparación puntual; no guardes los números sin coincidencia. Para las invitaciones, no envíes nada: abre la hoja de compartir.
Pide, lee y transforma los contactos
Dos toques separados: uno para el permiso y otro para cargar la lista. La variable contacts llega de forma asíncrona. La búsqueda de amigos, si la necesitas, se ejecuta en el servidor y solo para usuarios con sesión iniciada; en tu proyecto de Cursor, eso significa: Tus propias rutas de API o servicios.
javascript
var IN_APP = navigator.userAgent.indexOf("WebViewGold") !== -1; // tu token de user agent personalizado
function waitFor(name, timeoutMs, done) {
var start = Date.now();
(function check() {
if (typeof window[name] !== "undefined") { done(window[name]); }
else if (Date.now() - start < timeoutMs) { setTimeout(check, 100); }
else { done(undefined); }
})();
}
// Toque 1: después de tu propia pantalla explicativa
function askForContacts() {
if (!IN_APP) { showInviteLink(); return; }
window.location.href = "requestcontactpermission://";
}
// Toque 2: "Mostrar mis contactos"
function loadContacts() {
window.contacts = undefined;
window.location.href = "readcontacts://";
waitFor("contacts", 5000, function (list) {
if (!list) { showPermissionHint(); return; } // null = sin permiso
// formato: { "John Appleseed": ["888-555-5512", "888-555-1212"], ... }
var people = Object.keys(list).map(function (n) { return { name: n, phones: list[n] }; });
renderPicker(people); // nada preseleccionado, sin "Seleccionar todo"
});
}
// ¿Lo rechazó antes? Deja que el usuario lo cambie en Ajustes
function openAppSettings() { window.location.href = "settingsapp://"; }Lo que revisan Apple y Google
- Directriz 5.1.1 de Apple: pide acceso en contexto, solo para funciones que lo necesiten, con una descripción de uso que explique para qué. Las descripciones vagas son un motivo de rechazo frecuente.
- Directriz 5.1.2 de Apple: no uses los contactos para crear una base de datos de contactos ni para cedérsela a terceros, y contacta con personas solo por iniciativa explícita e individual del usuario: sin Seleccionar todo, sin contactos preseleccionados y mostrando lo que dirá el mensaje. Consulta el texto vigente de la directriz antes de enviar la app.
- Política de datos de usuario de Google Play: los datos de la agenda son personales y sensibles. Si los subes, muestra una divulgación destacada dentro de la app antes de la solicitud de permiso y declara Contactos en el formulario Data safety.
- Aplicar un hash a los números de teléfono no es anonimizarlos, porque el espacio de números es pequeño. Trata los hashes como datos personales, consérvalos solo el tiempo necesario e inclúyelos en tu política de privacidad y en la eliminación de cuentas (consulta la guía de eliminación de cuentas).
- Desde iOS 18, los usuarios pueden compartir solo los contactos que elijan. Asegúrate de que la función funcione con una lista corta y no insistas en pedir acceso completo.
Preguntas frecuentes
¿Qué devuelve readcontacts://?
Un objeto JSON con el nombre de cada contacto como clave y un array de números de teléfono para cada uno, guardado en la variable global contacts. Sin permiso, la variable es null. Los correos electrónicos, las direcciones postales y las fotos no forman parte del formato documentado.
¿Rechazará Apple una app que lee contactos?
No por leerlos, pero a menudo por cómo lo hace. Pide acceso en contexto con una descripción de uso clara, deja que los usuarios elijan personas concretas, no invites nunca a todos a la vez y no guardes la agenda en tu servidor salvo que la función lo necesite y tu política de privacidad lo indique.
¿Necesito acceso a los contactos para una función de invitación?
A menudo no. Una hoja de compartir con un enlace de invitación personal llega a WhatsApp, Mensajes y el correo sin ningún permiso y es mucho más fácil de explicar en la revisión. Usa el acceso a contactos cuando busques amigos o crees grupos a partir de contactos existentes.
¿Qué pasa si el usuario dice que no?
En ese caso, readcontacts:// deja la variable contacts en null. Ofrece el enlace de invitación en su lugar y, si el usuario cambia de opinión más adelante, abre los ajustes de la app con settingsapp:// para que pueda conceder el acceso.
Tres formas de llevar tu app a las tiendas
El mismo resultado, con distinta cantidad de trabajo por tu parte. Las tres incluyen la garantía de aprobación y soporte humano 24/7.
Hazlo tú mismo
$109 por plataforma, pago único
La licencia de WebViewGold: un proyecto de Xcode o Android Studio listo para usar. Pega tu URL, define nombre e icono, activa funciones, compila y envía. Actualizaciones gratuitas para siempre.
Ver planes en la página principalCloud Builder
$349 por licencia, complemento de pago único
Sin Mac, sin Xcode, sin Android Studio: configura en el navegador, compilamos ambas apps en la nube y las entregamos a App Store Connect y a Play Console.
Cómo funciona el Cloud Builder Prueba la demo gratuitaFull Service
$698 por plataforma $798
Envíanos tu URL y tu icono. Nuestro equipo configura, compila y entrega tu app en 72 horas, en marca blanca y con los proyectos fuente. Ambas plataformas por $1,158.
Detalles del Full Service Con tecnología de
Precios de la Oferta de invierno válidos hasta el 31 de diciembre de 2026.