Store Settings

Configure your store’s integration settings, API keys, and platform credentials

Overview

Store settings allow you to configure essential integration parameters for your Shopify store. This includes API keys for Ecomdrop and Dropi platforms, enabling automated workflows and order synchronization.

Configuration Sections

The configuration page is organized into four main tabs:

1. Ecomdrop Integration

   Configure your Ecomdrop API key and select flows for automation

2. Dropi Integration

   Set up Dropi credentials for order fulfillment synchronization

3. AI Assistant

   Customize your AI assistant for customer interactions

4. Status

   View the current status of all your integrations

Database Schema

All store configuration is stored in the ShopConfiguration model:

id · string · required

Unique identifier (UUID)

shop · string · required

Shop domain (unique, max 255 characters)

ecomdropApiKey · string

Ecomdrop API authentication key (encrypted)

nuevoPedidoFlowId · string

Flow ID for new order events (max 255 characters)

carritoAbandonadoFlowId · string

Flow ID for abandoned cart events (max 255 characters)

dropiStoreName · string

Dropi store identifier (max 255 characters)

dropiCountry · string

Dropi operation country code (max 10 characters)

dropiToken · string

Dropi API authentication token (encrypted)

createdAt · datetime

Configuration creation timestamp

updatedAt · datetime

Last update timestamp

Configuring Ecomdrop API Key

1. Obtain API Key

   Get your Ecomdrop API key from the Ecomdrop panel

2. Navigate to Configuration

   In your Shopify app, go to the Configuration page and select the Ecomdrop tab

3. Enter API Key

   Paste your API key in the “Clave API de Ecomdrop” field

   Your API key is stored securely and encrypted. It’s never displayed in plain text after saving.

4. Save Configuration

   Click “Conectar Ecomdrop IA y Refrescar Flujos” to save and load available flows

API Key Security

Never share your API key publicly. The app stores it encrypted in the database with the following security measures:

• Encrypted at rest in the database
• Transmitted over HTTPS only
• Not exposed in logs or client-side code
• Unique per store

Configuring Dropi Integration

Dropi integration enables automatic order synchronization with the Dropi fulfillment platform.

1. Prerequisites

   Ensure you have configured your Ecomdrop API key first

   Dropi configuration requires an active Ecomdrop API key to sync settings.

2. Enter Store Name

   Navigate to the Dropi tab and enter your Dropi store name

3. Select Country

   Choose your operation country from the dropdown:

   • Colombia (CO)
   • Ecuador (EC)
   • Chile (CL)
   • Guatemala (GT)
   • México (MX)
   • Panamá (PA)
   • Perú (PE)
   • Paraguay (PY)
4. Enter Dropi Token

   Input your Dropi API token in the secure field

   The token is masked after saving. Click “Editar Token” to update it later.

5. Save Configuration

   Click “Guardar” to save your Dropi settings

Country-Specific Field Mapping

The app automatically maps your country selection to the correct Dropi bot field:

Country	Code	Field ID
Colombia	CO	640597
Ecuador	EC	805359
Chile	CL	665134
Guatemala	GT	747995
México	MX	641097
Panamá	PA	742965
Perú	PE	142979
Paraguay	PY	240677

Updating Configuration

You can update any configuration setting at any time:

Updating Ecomdrop API Key

1. Go to Configuration > Ecomdrop tab
2. Enter the new API key in the input field
3. Click “Actualizar Conexión y Refrescar Flujos”
4. The system will reload available flows automatically

Editing Dropi Token

1. Go to Configuration > Dropi tab
2. Click “Editar Token” next to the masked token
3. Enter the new token
4. Click “Guardar Cambios” or “Cancelar” to abort

You must enter a complete token when updating. The field cannot be empty.

Changing Flow Assignments

1. Navigate to Configuration > Ecomdrop tab
2. Scroll to “Configuración de Flujos”
3. Select different flows from the dropdowns
4. Click “Guardar Configuración de Flujos”

Flow changes take effect immediately for new events.

Viewing Configuration Status

The Status tab provides an overview of all your integrations:

Status Indicators

Ecomdrop Status

• Configured: Shows green badge with last update timestamp
• Not Configured: Shows gray badge with setup instructions

Dropi Status

• Configured: Displays store name and country
• Not Configured: Shows prompt to configure in Dropi tab

Active Flows

Displays which flows are assigned to:

• Nuevo Pedido (New Orders)
• Carrito Abandonado (Abandoned Carts)

API Endpoints

Save Ecomdrop API Key

POST /app/configuration
Content-Type: application/x-www-form-urlencoded

intent=save_api_key
apiKey=your_api_key_here

Save Dropi Configuration

POST /api/integrations/dropi/save
Content-Type: application/x-www-form-urlencoded

store_name=my_store
country=CO
dropi_token=your_token_here

Troubleshooting

API Key Not Working

Symptoms: Flows don’t load after entering API key

Solutions:

1. Verify the API key is correct in the Ecomdrop panel
2. Check that your Ecomdrop account has active flows
3. Review browser console for error messages
4. Try clearing the flows cache by re-saving the API key

Dropi Configuration Fails

Symptoms: Error message when saving Dropi settings

Solutions:

1. Ensure Ecomdrop API key is configured first
2. Verify all required fields are filled
3. Check that the Dropi token is valid
4. Confirm the country code matches your Dropi account

Changes Not Saving

Symptoms: Configuration reverts after page reload

Solutions:

1. Check for JavaScript errors in browser console
2. Verify network connectivity
3. Ensure you have proper permissions in Shopify
4. Try refreshing the page and reconfiguring

Next Steps

Flow Management

Learn how to set up and manage Ecomdrop flows

Webhooks

Understand webhook integration and event handling