Skip to main content
Morada.ai is an AI sales agent for the real estate market. Its agent, Mia, talks to leads over WhatsApp, qualifies them, and moves them through the sales pipeline. The Data Export API exposes the conversations, messages, contacts, and deals of your workspace so they can be analyzed alongside the rest of your data.

​
1. Add your Morada.ai access

  1. In the Sources tab, click on the “Add source” button located on the top right of your screen. Then, select the Morada.ai option from the list of connectors.
  2. Click Next and you’ll be prompted to add your access.
  • API Key: Your workspace API key, in the mk_... format. Generate it inside Morada.ai under Integrações → Configurar API.
  • Start Date: (Optional, advanced) The earliest change timestamp to sync on the first run. Leave it empty to export the full history of your workspace.
The API key grants read access to every record in the workspace it belongs to. Treat it as a secret.
  1. Click Next.

​
2. Select your Morada.ai streams

  1. The next step is letting us know which streams you want to bring. You can select entire groups of streams or only a subset of them.
    Tip: The stream can be found more easily by typing its name.
If you don’t see a stream you were expecting to find, please check if your access key has access to it. If that’s not the issue, then it’s probably because we still haven’t implemented it. Feel free to get in touch and request it!
  1. Click Next.

​
3. Configure your Morada.ai data streams

  1. Customize how you want your data to appear in your catalog. Select the desired layer where the data will be placed, a name for each table (which will effectively contain the fetched data) and the type of sync.
  • Layer: choose between the existing layers on your catalog. This is where you will find your new extracted tables as the extraction runs successfully.
  • Table name: we suggest a name, but feel free to customize it. You have the option to add a prefix to all tables at once and make this process faster!
  • Sync Type: depending on the data you are bringing to the lake, you can choose between INCREMENTAL and FULL_TABLE. Read more about Sync Types here.
  1. Click Next.

​
4. Configure your Morada.ai data source

  1. Describe your data source for easy identification within your organization. You can inform things like what data it brings, to which team it belongs, etc.
  2. To define your Trigger, consider how often you want data to be extracted from this source. This decision usually depends on how frequently you need the new table data updated (every day, once a week, or only at specific times).
  3. Optionally, you can define some additional settings (if available).
  • Configure Delta Log Retention and determine for how long we should store old states of this table as it gets updated. Read more about this resource here.
  • Determine when to execute an Additional Full Sync. This will complement the incremental data extractions, ensuring that your data is completely synchronized with your source every once in a while.

​
Check your new source!

  1. Click Next to finalize the setup. Once completed, you’ll receive confirmation that your new source is set up!
  2. You can view your new source on the Sources page. Now, for you to be able to see it on your Catalog, you have to wait for the pipeline to run. You can now monitor it on the Sources page to see its execution and completion. If needed, manually trigger the pipeline by clicking on the refresh icon. Once executed, your new table will appear in the Catalog section.
If you encounter any issues, reach out to us via Slack, and we’ll gladly assist you!

​
How the data is replicated

Every stream is a change feed keyed by id, and every record carries a cursor_at timestamp that marks when the record last changed. Incremental syncs ask Morada.ai for everything that changed after the highest cursor_at already extracted, so records that were updated in the source reappear and are updated in your table.
Morada.ai does not emit deletion events. When a record is deleted in the source, it simply stops appearing in the feed, and no signal marks the removal. To reconcile deletions, schedule an Additional Full Sync so the table is rebuilt from a complete export.
Some fields hold workspace-specific attributes whose structure varies per account, such as props, metadata, and content. They are delivered as JSON strings, so you can parse them in a Query when you need the individual keys.

​
Rate limits

Morada.ai allows around 120 requests per minute per workspace. The connector stays below that limit on its own and automatically waits and retries when the API asks it to, so no configuration is needed on your side. Very large first extractions simply take longer to complete.

​
Streams and Fields

Below you’ll find all available data streams from Morada.ai and their corresponding fields. All streams share the id, workspace_id, and cursor_at fields.
People your workspace has interacted with.Key Fields:
  • id - Unique identifier of the contact
  • workspace_id - Identifier of the Morada.ai workspace the contact belongs to
  • name - Full name of the contact
  • email - Email address of the contact
  • phone_number - Phone number of the contact, typically the WhatsApp number used in conversations
  • banned_at - Timestamp when the contact was blocked, when the contact has been blocked
  • props - Additional workspace-specific attributes of the contact, as a JSON string
  • cursor_at - Change watermark of the record, used as the incremental replication key
Conversations handled by the AI agent (Mia).Key Fields:
  • id - Unique identifier of the conversation
  • workspace_id - Identifier of the Morada.ai workspace the conversation belongs to
  • person_id - Identifier of the contact this conversation is with
  • agent_id - Identifier of the AI agent (Mia) responsible for the conversation
  • deal_id - Identifier of the deal associated with the conversation, when there is one
  • target - Target of the conversation, such as the channel address the contact was reached at
  • started_at - Timestamp when the conversation started
  • finished_at - Timestamp when the conversation was closed, when it already ended
  • last_message_at - Timestamp of the most recent message exchanged in the conversation
  • props - Additional workspace-specific attributes of the conversation, as a JSON string
  • cursor_at - Change watermark of the record, used as the incremental replication key
Sales opportunities tracked in your workspace.Key Fields:
  • id - Unique identifier of the deal
  • workspace_id - Identifier of the Morada.ai workspace the deal belongs to
  • person_id - Identifier of the contact related to the deal
  • agent_id - Identifier of the AI agent (Mia) responsible for the deal
  • owner_id - Identifier of the user who owns the deal
  • status - Current status of the deal in the sales pipeline
  • title - Title of the deal
  • props - Additional workspace-specific attributes of the deal, as a JSON string
  • cursor_at - Change watermark of the record, used as the incremental replication key
Individual messages exchanged inside conversations.Key Fields:
  • id - Unique identifier of the message
  • workspace_id - Identifier of the Morada.ai workspace the message belongs to
  • conversation_id - Identifier of the conversation this message belongs to
  • actor - Author of the message, such as mia for the AI agent or human for a person
  • type - Type of the message, such as text or image
  • content - Body of the message. Non-textual payloads are delivered as a JSON string
  • metadata - Additional message metadata, as a JSON string
  • created_at - Timestamp when the message was created
  • delivered_at - Timestamp when the message was delivered, when delivery was confirmed
  • read_at - Timestamp when the message was read, when a read receipt was received
  • cursor_at - Change watermark of the record, used as the incremental replication key