# 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](/demo?product=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](/explained/apple-messages/does-sent-mean-delivered-or-read) 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](/docs/ai/mcp-server). 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 prueba                                     | Acción                                                                                | Resultado esperado                                                      |
| -------------------------------------------------- | ------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| La misma respuesta del cliente se observa de nuevo | Resué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 negocio         | Devuelve 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 recorrido       | Inspecciona 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

- [Explora la funcionalidad relacionada de Apple Messages](/products/apple-messages/api).
- [Encuentra guías y respuestas sobre Apple Messages](/products/apple-messages/resources).
- [Prepara tu primera conversación completa](/products/apple-messages/getting-started).

## Related resources

- [What is Apple Messages for Business?](/explained/apple-messages/what-is-apple-messages-for-business) (answer)
- [Apple Messages for Business](/products/apple-messages) (product)

[Get an implementation brief](/learn/workspace?topic=apple-messages)
