El registro de solicitudes API
Los webhooks que Sync Pro recibió para tu equipo, guardados tal como llegaron con la respuesta que recibieron, cómo encontrar los que fallaron, y cómo volver a ejecutar una llamada de Callpicker con error.
Lo que le llega a Sync Pro desde fuera — un mensaje de WhatsApp o un aviso de entrega desde Meta, una llamada terminada desde Callpicker — entra como un webhook. Todos los webhooks se guardan tal como llegaron, junto con la respuesta que Sync Pro les dio, aunque no se hayan podido usar. Solicitudes API, en el menú del equipo, muestra los que son de tu equipo, con lo más reciente primero.
Lo ves cuando tu rol tiene Ver en la fila Solicitud API de la pantalla Roles. Para volver a ejecutar una solicitud con error, el rol necesita además el interruptor Reejecutar solicitudes API del equipo, que el rol del dueño ya tiene. Ve Roles y permisos.
Esta es la pantalla que se abre cuando alguien dice «el mensaje nunca llegó» o «la llamada no aparece».
Qué guarda un registro
| Campo | Qué te dice |
|---|---|
| Fuente | Quién lo mandó: whatsapp para Meta, callpicker para Callpicker. |
| Endpoint | A qué dirección llegó. |
| Identificador | La referencia que usó quien lo mandó, para cruzarla con sus propios registros. Los registros de Callpicker llevan el ID de la llamada; los de WhatsApp lo dejan vacío. |
| Código HTTP | La respuesta que Sync Pro le dio a quien lo mandó. Callpicker siempre recibe 200. Los registros de antes de que Sync Pro guardara las respuestas lo muestran vacío. |
| Error | Por qué la solicitud no se pudo usar, cuando no se pudo. Vacío cuando pasó bien. |
| Solicitud | El contenido completo, exactamente como se recibió. Se muestra al abrir el registro. |
| Respuesta | La respuesta que se dio, con su error, en JSON. Se muestra al abrir el registro. |
| Creado el | Cuándo llegó. |
El contenido es la parte útil. Es lo que de verdad mandó el emisor, no la interpretación que Sync Pro hizo de ello, que es lo que permite distinguir una cosa de la otra.
Encontrar las que fallaron
Usa el filtro Con error para quedarte solo con las solicitudes que no se pudieron usar. La columna Error dice por qué:
| Error | Qué significa |
|---|---|
| Call Picker no está habilitado para el equipo | Llegó una llamada mientras tu equipo no tenía el módulo de Callpicker. |
| El cuerpo de la petición no es válido | El contenido del emisor no se pudo leer, o le falta lo que Sync Pro necesita, como el ID de la llamada. |
| Error al procesar la petición | La llamada llegó bien, pero registrarla falló. |
| WhatsApp no está habilitado para el equipo y El equipo no existe | Estas se guardan fuera de tu registro; ve abajo. |
Lo que no aparece en tu registro
Todos los webhooks se guardan, pero algunos se guardan sin equipo, así que no aparecen en el registro de ningún equipo:
- Los mensajes para un número que no está enlazado a tu equipo. Un webhook para un número que ningún equipo tiene enlazado por completo no tiene equipo al cual pertenecer. Eso incluye tu propio número mientras está enlazado pero sin confirmar, o después de que se desconectó. Un webhook de WhatsApp que no dice para qué número es se guarda igual.
- Los cambios de estado de las plantillas y los webhooks de WhatsApp que Sync Pro no puede leer. Cuando Meta aprueba, rechaza o pausa una plantilla, Sync Pro actualiza la plantilla; el webhook se guarda fuera de los registros de los equipos, igual que un contenido de WhatsApp que no se puede leer.
- Las llamadas de Callpicker enviadas a una dirección con un equipo que no existe. Una URL de webhook copiada mal, o que se quedó apuntando a un equipo que se eliminó.
Una llamada que Callpicker manda dos veces conserva un solo registro: los registros se identifican por el ID de la llamada, así que la segunda llegada no agrega otro.
Leerlo cuando falta algo
La pregunta que el registro responde primero es cuál de tres cosas pasó:
- No hay registro. Normalmente el webhook nunca llegó, y el problema está fuera de Sync Pro: en Callpicker, la dirección no está configurada ahí o apunta a otro lado; en WhatsApp con acceso por token, el webhook no está puesto en tu aplicación de Meta. Antes de concluir eso, descarta los casos de Lo que no aparece en tu registro — un número que no está enlazado por completo a tu equipo es el más común. Revisa el módulo de WhatsApp o el módulo de Callpicker.
- Hay registro con error. El webhook llegó y Sync Pro no lo pudo usar. La columna Error dice por qué; corrige la causa y luego vuelve a ejecutarlo.
- Hay registro sin error pero no pasó nada. El webhook llegó y procesarlo no produjo lo que esperabas. El contenido te dice qué traía en realidad.
Volver a ejecutar uno
Una solicitud de Callpicker con error tiene la acción Reejecutar al abrirla. Procesa de nuevo dentro de Sync Pro la llamada guardada, exactamente como llegó, así que no tienes que pedirle a Callpicker que la vuelva a mandar. Corrige primero la causa —por ejemplo, prende el módulo de Callpicker— y luego presiona Reejecutar:
- Cuando pasa, Sync Pro avisa que la petición se procesó de nuevo, el error se limpia y la llamada se registra.
- Cuando la causa sigue ahí, Sync Pro avisa que la petición sigue con error y por qué, y el registro conserva su error.
Reejecutar nunca registra dos veces una llamada que ya estaba registrada. Las solicitudes sin error no lo ofrecen, y las de WhatsApp tampoco: puedes leer su error, pero no se pueden volver a ejecutar desde aquí.
Qué no es
No es una API de salida para tus propios sistemas, y no es un lugar desde donde mandar solicitudes. Es el registro de lo que llegó y de lo que Sync Pro respondió.