Sign inGet started

Integra un recorrido de cliente en Apple Messages

Conecta la identidad del negocio, el contenido nativo, las respuestas del cliente y los resultados de negocio a través del contrato Bird actual.

Requisitos previos

Prepara un espacio de trabajo de Bird, una empresa aprobada para Apple Messages, credenciales con alcance definido y una conversación de prueba autorizada. Contacta a un especialista en Apple Messages para confirmar el acceso al espacio de trabajo y obtener el contrato de operaciones admitidas para tu integración. Conecta tu agente de programación al servidor MCP de Bird o usa el cliente API de tu aplicación, con los mismos permisos de espacio de trabajo y negocio.

1. Mapea las dos rutas de direccionamiento

Las respuestas ordinarias usan la identidad de Apple de la conversación abierta. Las invitaciones usan una operación aprobada independiente, dirigida a un número de teléfono y con consentimiento explícito. Lee los campos reales y la audiencia de la operación antes de implementar cualquiera de las dos rutas.

2. Prepara el intercambio nativo

Elige un tipo de contenido soportado y una respuesta esperada específica. Conserva las referencias de negocio, conversación, solicitud y mensaje en tu aplicación. Mantén las credenciales y el contenido privado de los mensajes fuera de los ejemplos públicos.

3. Verifica el dispositivo y la respuesta

Envía a través de la ruta de prueba aprobada, inspecciona la representación nativa y devuelve una respuesta. Correlaciona esa entrada con la solicitud original y valídala antes de ejecutar una acción de negocio.

4. Gestiona los resultados asíncronos

Un envío aceptado por la pasarela de Apple se registra como enviado; no es un acuse de entrega al dispositivo ni de lectura. Mantén el procesamiento de mensajes separado del resultado del pedido, la reserva o la identidad. Ten en cuenta las observaciones repetidas o desordenadas sin asumir un orden de entrega universal ni deduplicación por parte del proveedor. Sigue la explicación de estados para decidir qué evento puede avanzar la tarea del cliente.

5. Construye y revisa con un agente de programación

Conecta el agente a través del servidor Bird MCP. Pídele que inspeccione el espacio de trabajo, el negocio y el contenido existente antes de proponer cambios. Proporciona el contrato de operaciones de Apple Messages, esta guía y un modelo de aplicación con los datos sensibles ocultos.
Haz que el agente prepare mensajes nativos y ramas del recorrido, luego prueba un intercambio exitoso y un caso materialmente distinto de respuesta rechazada o incierta. Revisa el contenido exacto, las acciones conectadas y los permisos antes de publicar. Exige confirmación para el contacto con el cliente y las acciones de negocio con consecuencias. Inspecciona la operación original antes de reintentar.

Verifica la integración en sus límites

Usa una selección nativa de cita como intercambio de prueba. Rastrea el negocio y la conversación aprobados, la solicitud de salida, la respuesta seleccionada por el cliente y la reserva confirmada. Son registros conceptuales que debes correlacionar en tu aplicación; usa los nombres de campos reales y las formas de operación del contrato disponible en tu espacio de trabajo.
Caso de pruebaAcciónResultado esperado
La misma respuesta del cliente se observa de nuevoResuélvela contra la solicitud ya registrada y la operación de la aplicación.Una observación repetida no crea otra reserva.
La aplicación deniega la acción de negocioDevuelve un rechazo útil o una alternativa sin cambiar el resultado de la acción.No se le dice al cliente que la reserva o compra se completó.
Un agente prepara una revisión del recorridoInspecciona su contenido, acciones conectadas y permisos efectivos antes de publicar.La experiencia publicada coincide con la revisión que tu equipo revisó.

Solución de problemas

Si una operación es rechazada, verifica el espacio de trabajo, la aprobación del negocio y los permisos de la cuenta. Si un mensaje es aceptado pero la tarea del cliente falla, inspecciona la representación en el dispositivo y el sistema de negocio conectado por separado. Usa las operaciones API publicadas exactas en lugar de adaptar por suposición el nombre de método de otro proveedor.

Próximos pasos

Recursos relacionados

Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.

Obtener un resumen de implementación