Requisitos previos
Cuenta de NotMeta
- Cuenta de NotMeta activa
- Acceso de administrador o desarrollador
- WhatsApp Business API configurado
Herramientas de desarrollo
- Cliente HTTP (Postman, curl, etc.)
- Editor de código
- Navegador web
- Acceso a terminal/consola
Obtener credenciales de API
1. Acceder al panel de desarrolladores
- Inicia sesión en tu cuenta de NotMeta
- Ve a “Configuración” > “API”
- Haz clic en “Generar token de API”
2. Configurar permisos
Selecciona los permisos necesarios para tu aplicación:- Conversaciones: Leer y escribir mensajes
- Usuarios: Gestionar equipo
- Reportes: Acceder a métricas
- Webhooks: Configurar notificaciones
- Configuración: Modificar ajustes
3. Generar token
- Ingresa un nombre descriptivo para tu token
- Selecciona la fecha de expiración
- Haz clic en “Generar token”
- Importante: Copia y guarda el token de forma segura
Configuración del entorno
Variables de entorno
Crea un archivo.env con tus credenciales:
Configuración de HTTPS
Para desarrollo local, puedes usar un túnel HTTPS:Primeras llamadas a la API
Verificar conexión
Obtener información de la cuenta
Configuración de webhooks
1. Crear endpoint webhook
2. Registrar webhook
SDKs oficiales
JavaScript/Node.js
Python
PHP
Herramientas de desarrollo
Postman Collection
Importa nuestra colección de Postman para probar la API:- Descarga la colección desde GitHub
- Importa en Postman
- Configura las variables de entorno:
base_url: https://api.notmeta.comapi_token: Tu token de API
Testing
Mejores prácticas
Seguridad
- Nunca hardcodees tokens en el código
- Usa variables de entorno para credenciales
- Implementa verificación de firmas de webhooks
- Usa HTTPS en producción
Manejo de errores
Rate limiting
Solución de problemas
Error 401: Unauthorized
- Verifica que tu token sea válido
- Confirma que el token no haya expirado
- Revisa los permisos asignados al token
Error 429: Too Many Requests
- Implementa backoff exponencial
- Reduce la frecuencia de las solicitudes
- Considera usar webhooks en lugar de polling
Error 500: Internal Server Error
- Verifica el formato de tu solicitud
- Contacta soporte técnico si persiste
- Revisa el estado del servicio
Recursos adicionales
Autenticación
Aprende sobre los diferentes métodos de autenticación
Webhooks
Configura notificaciones en tiempo real