Guía de integración

1. Integración de WhatsApp Business API

La integración de WhatsApp Business API permite convertir automáticamente los mensajes de WhatsApp entrantes de sus clientes en pedidos.

Información requerida

Paso 1: Crear una cuenta de Meta Business

1. Vaya a business.facebook.com.
2. Si no tiene una cuenta de Meta Business, cree una nueva.
3. Complete la verificación empresarial.

Paso 2: Crear una cuenta de Meta Developer

1. Vaya a developers.facebook.com.
2. Haga clic en el botón «Comenzar» y cree su cuenta de desarrollador.
3. Vincúlela con su cuenta de Meta Business.

Paso 3: Crear una aplicación de WhatsApp

1. En el Developer Dashboard, haga clic en el botón «Crear aplicación».
2. Seleccione «Empresa» como tipo de aplicación.
3. Introduzca el nombre de la aplicación (p. ej., «Integración Convord»).
4. Seleccione su cuenta de Meta Business y créela.

Paso 4: Añadir el producto WhatsApp

1. En el panel de su aplicación, vaya a la sección «Añadir producto».
2. Busque el producto «WhatsApp» y haga clic en el botón «Configurar».
3. Confirme la cuenta de Meta Business que se vinculará.

Paso 5: Obtener el ID del número de teléfono

1. En el menú izquierdo, vaya a WhatsApp → Configuración.
2. Copie el valor «ID del número de teléfono» (Phone Number ID).
3. Pegue este valor en el campo «ID del número de teléfono» del panel de Convord.

Paso 6: Obtener el token de acceso

1. En el menú izquierdo, vaya a WhatsApp → Configuración de API.
2. Copie el token de la sección «Token de acceso temporal» (Temporary Access Token).
3. Pegue este valor en el campo «Token de acceso» del panel de Convord.

Paso 7: Configuración del webhook

1. En el menú izquierdo, vaya a WhatsApp → Configuración.
2. En la sección «Webhook», haga clic en el botón «Editar».
3. Introduzca la URL del webhook del panel de Convord como Callback URL:
   https://su-dominio.com/webhook/whatsapp
4. Introduzca el valor WHATSAPP_VERIFY_TOKEN de su archivo .env como Verify Token.
5. Haga clic en el botón «Verificar y guardar».

Paso 8: Suscribirse a los campos del webhook

En la sección «Campos del webhook» bajo la configuración del webhook, suscríbase al campo messages (marca ✓).

Paso 9: Probar

1. Envíe un mensaje de prueba a su número de WhatsApp (p. ej., «2 cajas de cola, 1 caja de agua»).
2. Compruebe la sección Pedidos en el panel de Convord.
3. Si su mensaje se convirtió automáticamente en un pedido, ¡la integración ha sido exitosa!

2. Integración de facturación / e-Factura

Activar la función de facturación

1. En la página de Integraciones, active el interruptor en la sección Facturación.
2. Seleccione su método de creación de facturas:
   • Factura del sistema: Crea facturas con la plantilla PDF propia de Convord.
   • Uyumsoft: Emite facturas electrónicas e-Fatura y e-Arşiv conformes con GİB.

Información general de facturación

Configuración de e-Factura Uyumsoft

1. Adquiera el servicio e-Factura/e-Arşiv en uyumsoft.com.
2. Tras la activación de su cuenta, obtenga sus credenciales de acceso a la API.
3. Seleccione «Uyumsoft» como método de creación de facturas.
4. Introduzca el Nombre de usuario y la Contraseña proporcionados por Uyumsoft.
5. Haga clic en el botón Guardar.

3. Notificaciones de Telegram

La integración de Telegram le permite recibir notificaciones instantáneas sobre nuevos pedidos y eventos importantes.

Información requerida

Paso 1: Crear un bot de Telegram

1. En Telegram, busque el bot @BotFather e inicie una conversación.
2. Envíe el comando /newbot.
3. Asigne un nombre a su bot (p. ej., «Convord Notificaciones»).
4. Asigne un nombre de usuario a su bot (p. ej., convord_notify_bot).
5. BotFather le proporcionará un Token del bot. Copie este valor.

Paso 2: Introducir el token del bot

1. Vaya a la página Integraciones en el panel de Convord.
2. Pegue el token en el campo «Token del bot» de la sección Telegram.

Paso 3: Encontrar su Chat ID

Para Chat ID personal:

1. En Telegram, busque el bot @userinfobot o @RawDataBot.
2. Envíe /start al bot.
3. Copie el valor Chat ID del mensaje devuelto.

Para Chat ID de grupo:

1. Añada su bot a un grupo de Telegram.
2. Envíe un mensaje en el grupo.
3. Abra la siguiente URL en su navegador:
   https://api.telegram.org/bot<BOT_TOKEN>/getUpdates
4. Encuentre el valor "chat":{"id":-100XXXXXXXXXX} en el JSON devuelto.

Paso 4: Introducir Chat ID y probar

1. Pegue el valor del Chat ID en el campo «Chat ID» del panel de Convord.
2. Haga clic en el botón Guardar.
3. Cree un nuevo pedido y compruebe si llega una notificación por Telegram.

4. Solución de problemas

5. Recomendaciones de seguridad

• Nunca comparta sus claves API con terceros.
• Si utiliza un token permanente de WhatsApp, renóvelo periódicamente.
• Si su token de bot de Telegram ha sido comprometido, revóquelo mediante BotFather con el comando /revoke.
• Almacene sus credenciales de API de Uyumsoft en un entorno seguro.
• Cambie regularmente la contraseña de su cuenta de la Plataforma y utilice una contraseña segura.

6. Soporte

Si necesita ayuda con la configuración de integraciones:

• Correo electrónico: destek@convord.com
• Teléfono: +90 XXX XXX XX XX
• Asunto: «Soporte de integración – [WhatsApp/Telegram/e-Factura]»