> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alvys.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración Twilio (New)

> Conecte la nueva integración Twilio a Alvys para habilitar Driver Chat SMS, cumplir con A2P 10DLC y enrutar mensajes desde el número de teléfono correcto de la subsidiaria.

<Note>
  **Se aplica a:** Admin · Partner Admin

  **Módulo:** Management > Integrations

  **Proveedor:** Twilio · **Tipo de integración:** Unidireccional · **Dirección:** Alvys envía mensajes SMS salientes a través de Twilio a los teléfonos de los conductores

  Conecte Twilio a Alvys para habilitar Driver Chat, que permite a los despachadores enviar y recibir mensajes SMS con conductores directamente dentro de Alvys. Todos los clientes deben actualizar a la integración Twilio (New) para cumplir con los requisitos de cumplimiento A2P 10DLC y seguir usando Driver Chat.
</Note>

## Resumen

La integración Twilio (New) (también denominada Twilio V2 o la integración Twilio actualizada) impulsa Driver Chat en Alvys. Una vez conectada, los despachadores pueden enviar y recibir mensajes de texto con conductores desde la plataforma Alvys. Twilio enruta esos mensajes como SMS a los teléfonos de los conductores.

Esta versión de la integración agrega soporte para un selector de subsidiaria, que garantiza que los mensajes se envíen desde la entidad legal correcta cuando administra varias marcas o subsidiarias. También incluye un flujo de incorporación que registra su empresa en el marco de cumplimiento A2P 10DLC de Twilio, un requisito para todos los mensajes de texto comerciales en los Estados Unidos.

Esta es una integración unidireccional: Alvys envía SMS salientes a través de Twilio a los conductores.

## Requisitos previos

Antes de conectar Twilio (New), necesita:

* Acceso Admin o Partner Admin en Alvys.
* Un sitio web comercial con una política de privacidad y una página de términos y condiciones que cumpla con los requisitos A2P 10DLC de Twilio. Revise la [guía de cumplimiento de Twilio](https://help.twilio.com/articles/11847054539547-A2P-10DLC-Campaign-Approval-Best-Practices#h_01KGNGR2MSVFT20XRE1HF4QW29) para ver qué debe incluirse.
* Una persona de contacto principal a la que Twilio pueda comunicarse si surgen problemas durante el registro.
* El EIN (Employer Identification Number) de cada entidad legal que esté registrando.

## Cómo conectar

Vaya a Twilio (New) en Alvys.

* Inicie sesión en Alvys y vaya a Management > Integrations.
* Localice la integración Twilio (New).

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/b4be468bc703.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=4f7fd0c9586e64ebbdea1e319b727db2" alt="Página Integrations de Alvys que muestra el mosaico de integración Twilio (New) en la sección Management > Integrations." data-og-width="664" width="664" data-og-height="444" height="444" data-path="images/help/b4be468bc703.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/b4be468bc703.png?w=280&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=a4f8b9fdb0d430d0fa90bfb3e96d9893 280w, https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/b4be468bc703.png?w=560&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=9d2296f5a60ecf1cd67663a68fd7f024 560w, https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/b4be468bc703.png?w=840&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=527d9f87e11817ae90c0afbdfe7f247a 840w, https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/b4be468bc703.png?w=1100&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=a8b10287e178a8fd369492febcda1908 1100w, https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/b4be468bc703.png?w=1650&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=4ebfd1aac4ff39f0c3c241dd3a0d5bd2 1650w, https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/b4be468bc703.png?w=2500&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=af6b690eed5a640b2dd6063cf847f703 2500w" />

  \*Página Integrations de Alvys que muestra el mosaico de integración Twilio (New) en la sección Management > Integrations. \*
</Note>

Complete el flujo de incorporación, trabajando cada sección en orden.

* Elija su código de área para su número de teléfono Twilio.
* Configure un número de reenvío (opcional): las llamadas a su número Twilio se reenviarán a este número.
* Agregue subsidiarias: seleccione las subsidiarias bajo su empresa matriz que compartan el mismo EIN. Para subsidiarias con EIN separados, complete el flujo de incorporación por separado para cada entidad.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/18c5fabc6ca7.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=f9e6b30f694d05edeb4afae3d73c3351" alt="Flujo de incorporación Twilio (New) de Alvys que muestra el paso del selector de subsidiaria del formulario &#x22;Configure Twilio&#x22;." width="493" height="809" data-path="images/help/18c5fabc6ca7.png" />

  \*Flujo de incorporación Twilio (New) de Alvys que muestra el paso del selector de subsidiaria del formulario "Configure Twilio". \*
</Note>

* Proporcione información de contacto: ingrese una persona de contacto principal a la que Twilio pueda comunicarse si surgen problemas.
* Agregue su sitio web, política de privacidad y términos y condiciones. Deben cumplir con los requisitos A2P 10DLC de Twilio; consulte la [guía de cumplimiento de Twilio](https://help.twilio.com/articles/11847054539547-A2P-10DLC-Campaign-Approval-Best-Practices#h_01KGNGR2MSVFT20XRE1HF4QW29) para los requisitos exactos.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/d4accd8b055a.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=92ca48fcd936db9f9e961fb4f02216ac" alt="Formulario Alvys Twilio Paso 2 de 4 &#x22;Account Contact&#x22;" width="725" height="902" data-path="images/help/d4accd8b055a.png" />

  *Formulario Alvys Twilio Paso 2 de 4 "Account Contact"*
</Note>

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/72f58c636fd8.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=a48ec4b1c8ad1f354110d274b43f4850" alt="Formulario Alvys Twilio Paso 3 de 4 &#x22;Setup your Business Profile&#x22;" width="557" height="917" data-path="images/help/72f58c636fd8.png" />

  *Formulario Alvys Twilio Paso 3 de 4 "Setup your Business Profile"*
</Note>

* Supervise el indicador de progreso. Después de enviar, aparece un indicador de progreso. Los tres siguientes deben ponerse en verde antes de que su integración esté activa: Profile Status, Service Trust Product y Brand Status. El cronograma de revisión y aprobación lo controla Twilio y puede tardar hasta un mes en completarse.
* Desactive la integración Twilio anterior. Una vez que los tres pasos del indicador de progreso estén en verde, vuelva a Integrations y desactive su integración Twilio anterior. Revise todas las subsidiarias en busca de integraciones Twilio antiguas activadas previamente y elimínelas todas.

<Warning>
  ⚠️ Los chats de conductores anteriores no migrarán a la nueva integración. Deberá iniciar nuevos chats con los conductores, y los conductores deberán volver a optar por SMS.
</Warning>

<Warning>
  ⚠️ Momento de la migración: Si integró Twilio antes del 12 de mayo de 2025, debe actualizar a la integración Twilio (New) antes del 25 de julio de 2025 para seguir usando Driver Chat; después de esa fecha, su integración Twilio anterior se desactivará. · Si integró Twilio después del 12 de mayo de 2025, ya está en la integración Twilio (New) y no se requiere ninguna acción adicional.
</Warning>

## Qué se sincroniza

La integración Twilio (New) no sincroniza campos de datos estructurados entre sistemas. Enruta mensajes SMS entre Alvys y conductores a través de la infraestructura de mensajería de Twilio. El flujo de incorporación recopila la información del perfil comercial de su empresa (nombre de entidad legal, EIN, datos de contacto, sitio web y URL de políticas) y la envía a Twilio para el registro A2P 10DLC.

* Los mensajes enviados desde Alvys Driver Chat se enrutan de salida a través de Twilio a los teléfonos de los conductores mediante SMS.
* Los conductores deben optar por recibir mensajes de su número Twilio. Aparece un banner azul en la parte superior de la ventana de chat del conductor si el conductor necesita volver a optar después de la actualización, y muestra a qué número debe enviar el mensaje de opt-in.
* Cada entidad legal (subsidiaria) con un EIN diferente requiere un registro Twilio y un número de teléfono separados.

  Para confirmar que la integración funciona después de que los tres pasos del indicador de progreso se pongan en verde, vaya a Driver Chat en Alvys, abra una conversación con un conductor que haya optado por SMS, envíe un mensaje de prueba y confirme que el conductor lo recibe en su teléfono. Si el conductor aún no ha optado, verá un aviso para enviar un mensaje de opt-in a su número Twilio; una vez que opte, la mensajería funcionará con normalidad.

  <Warning>
    ⚠️ \*\*Límites y no admitido: \*\*

    * Cada entidad legal con un EIN separado debe registrarse de forma independiente; no puede combinar subsidiarias con EIN diferentes bajo un solo registro.
    * El historial de chat de conductores anterior no migra.
    * Los conductores deben volver a optar por SMS después de la actualización.
    * Los plazos de aprobación los establece Twilio y pueden tardar hasta un mes.
  </Warning>
* Cada entidad legal con un EIN separado debe registrarse de forma independiente; no puede combinar subsidiarias con EIN diferentes bajo un solo registro.
* El historial de chat de conductores anterior no migra.
* Los conductores deben volver a optar por SMS después de la actualización.
* Los plazos de aprobación los establece Twilio y pueden tardar hasta un mes.

## Solución de problemas

### La integración muestra "needs attention"

Haga clic en el estado "needs attention" para abrir el panel de detalles de estado.

<Note>
  Integración Twilio (New) que muestra el estado "needs attention" con un indicador de clic.

  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/b37d798efbe4.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=4a97e5c46d23dc155beaac0eabcddf18" alt="Notion Image" width="614" height="236" data-path="images/help/b37d798efbe4.png" />
</Note>

* Revise el panel de estado para identificar qué sección falló: Profile Status, Service Trust Product o Brand Status.
* Haga clic en el icono de edición junto a la sección fallida y vuelva a enviar la información corregida a Twilio para una revisión adicional.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/63be49f5d47c.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=b67c402c0eeecffd924a473afc9c3772" alt="Icono de edición Alvys Twilio (New) junto a una sección fallida y el formulario de reenvío." width="1062" height="2020" data-path="images/help/63be49f5d47c.png" />

  \*Icono de edición Alvys Twilio (New) junto a una sección fallida y el formulario de reenvío. \*

  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/409c75b780ba.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=f67ea196d26eef489194546163fc350b" alt="Imagen que muestra el formulario &#x22;Edit Business Profile&#x22;" width="1020" height="1590" data-path="images/help/409c75b780ba.png" />

  *Imagen que muestra el formulario "Edit Business Profile"*
</Note>

Guarde sus cambios para volver a enviar a verificación.

### El estado de marca falló

* Twilio enviará un correo electrónico a su contacto indicado con instrucciones para resolver el problema. Siga las instrucciones de ese correo y vuelva a enviar a través del icono de edición en el panel de estado (consulte arriba).

### El conductor no recibe mensajes

* Compruebe si aparece un banner azul en la parte superior de la ventana de chat del conductor en Alvys. Si aparece, el conductor aún no ha optado por el nuevo número Twilio.
* Pida al conductor que envíe el mensaje de opt-in al número que se muestra en el banner azul. Una vez que opte, la mensajería se reanudará.
* Si no aparece banner azul y el conductor sigue sin recibir mensajes, confirme que los tres pasos del indicador de progreso estén en verde en Management > Integrations > Twilio (New). Si algún paso no está en verde, la integración aún no está activa.
* Si todos los pasos están en verde y el conductor ha optado pero los mensajes siguen sin recibirse, contacte con el soporte de Alvys e incluya los detalles de su cuenta Twilio y la información del conductor afectado.

## Preguntas frecuentes

**P: ¿Qué pasa si no actualizo antes del 25 de julio de 2025?**

**R:** Si estaba en la integración Twilio anterior y no actualizó, su integración Twilio se desactivará y ya no podrá enviar ni recibir mensajes a través de Twilio en Alvys.

**P: ¿Puedo registrar varias subsidiarias a la vez?**

**R:** Solo si comparten el mismo EIN. Para subsidiarias con EIN diferentes, debe completar el flujo de incorporación por separado para cada entidad.

**P: Veo tres marcas de verificación verdes en el indicador de progreso. ¿Ya está todo listo?**

**R:** Tres marcas de verificación verdes significan que Twilio aprobó su registro. Si tiene preguntas sobre si su Driver Chat está completamente activo, contacte con el soporte de Alvys en [support@alvys.com](mailto:support@alvys.com) para confirmación.

**P: ¿Qué pasa con los chats de conductores anteriores después de la actualización?**

**R:** Los chats de conductores anteriores no migran a la nueva integración. Deberá iniciar nuevos chats con los conductores, y los conductores deben volver a optar por SMS.
