Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Mercaline2024/Ecomdrop-ia-connector-2/llms.txt

Use this file to discover all available pages before exploring further.

​
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:
CountryCodeField ID
ColombiaCO640597
EcuadorEC805359
ChileCL665134
GuatemalaGT747995
MéxicoMX641097
PanamáPA742965
PerúPE142979
ParaguayPY240677

​
Updating Configuration

You can update any configuration setting at any time:
  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
  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.
  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

  • Configured: Shows green badge with last update timestamp
  • Not Configured: Shows gray badge with setup instructions
  • Configured: Displays store name and country
  • Not Configured: Shows prompt to configure in Dropi tab
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

Symptoms: Flows don’t load after entering API keySolutions:
  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
Symptoms: Error message when saving Dropi settingsSolutions:
  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
Symptoms: Configuration reverts after page reloadSolutions:
  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

Build docs developers (and LLMs) love

Get started for freeTalk to us