Resumen
Este artículo le ayuda a solucionar problemas comunes al utilizar acciones de API de REST en Astra. Cubre problemas frecuentes como parámetros de formulario que faltan, limitaciones con los datos de lead, errores de autenticación y consideraciones de seguridad importantes para mantener sus integraciones funcionando de manera confiable.
Instrucciones
Formulario enviado: parámetros no se están pasando
Problema
Su API de REST recibe valores vacíos o que faltan cuando se envía un formulario personalizado.
Por qué sucede esto
Esto suele ocurrir cuando el marcador de posición utilizado en la configuración de la API de REST no coincide exactamente con el nombre del campo del formulario.
La coincidencia es sensible a mayúsculas y minúsculas y se basa en el sufijo del marcador de posición (la parte después del último .).
Cómo solucionarlo
Asegúrese de que el sufijo del marcador de posición coincida exactamente con el nombre del campo del formulario.
Ejemplos:
Campo del formulario
first_name→ Marcador de posición{{first_name}}o{{contact.first_name}}Campo del formulario
firstName→ Marcador de posición{{contact.first_name}}Razón: coincidencia de mayúsculas y minúsculas (
firstName≠first_name)
Después de corregir el marcador de posición, guarde la acción y vuelva a probarla.
Lead capturado: campos personalizados no funcionan
Problema
Desea enviar campos adicionales o personalizados con el evento Lead capturado.
Por qué sucede esto
El evento Lead capturado siempre envía una estructura de cuerpo de solicitud fija. Los campos personalizados no son compatibles con este tipo de evento.
Cualquier configuración personalizada de request_body es ignorada.
Qué puede hacer en su lugar
Si necesita enviar datos personalizados, utilice una de las siguientes opciones:
Formulario enviado evento con un formulario personalizado
Disparador basado en intención con un cuerpo de solicitud personalizable
Estas opciones le permiten controlar exactamente qué datos se envían a su API.
Errores de autenticación
Problema
Su API devuelve un error 401 No autorizado.
Cómo solucionarlo
Verifique que su clave de API o token sea correcta
Asegúrese de que el token no haya caducado
Después de actualizar las credenciales, vuelva a probar la acción.
Notas de seguridad
Astra incluye medidas de seguridad integradas para proteger sus datos e integraciones.
Credenciales protegidas
Las claves de API y las contraseñas se ocultan (
*****) al ver los detalles de la acción
Protección contra suplantación de solicitud del servidor (SSRF)
Las solicitudes a direcciones de red interna o privada se bloquean automáticamente
Modo de prueba disponible
Utilice el modo de prueba para validar su acción de API de REST sin afectar los datos en vivo o las analíticas
Siguiendo estas pautas, podrá solucionar problemas rápidamente y mantener sus acciones de API de REST seguras y confiables.