supaglue-labs / supaglue Goto Github PK

View Code? Open in Web Editor NEW

385.0 6.0 57.0 74.64 MB

Open source user-facing product integrations

Home Page: https://docs.supaglue.com

License: MIT License

Shell 0.48% Dockerfile 0.27% TypeScript 98.78% JavaScript 0.44% CSS 0.01% Batchfile 0.02%

integrations salesforce typescript workflows apis hubspot crm common-schema dynamics-365 gong

supaglue's Introduction

Website • Quickstart • Docs • Slack • Twitter

Supaglue

Supaglue is an open source developer platform for user-facing product integrations. It provides configurable connectors and platform tools to help developers at B2B companies simplify and scale their integrations with their customers' CRMs and sales stack. Supaglue can be self-hosted and runs alongside your stack.

Supaglue.Quickstart.mp4

Get Started

Run Supaglue locally

git clone -b v0.25.7 https://github.com/supaglue-labs/supaglue.git && cd supaglue
./scripts/create_quickstart_env.sh
docker compose up

The default login credentials are username: admin and password: admin. Alternatively, you can set the ADMIN_PASSWORD environment variable in the .env file created by ./scripts/create_quickstart_env.sh.

Features

Supaglue offers 3 main ways to integrate with your customers' providers.

Managed Syncs: managed service that continuously syncs data from your customers' SaaS tools into your application database or data warehouse.
Actions API: single access point to perform common read and write operations against third-party providers.
Real-time events: managed service that sends webhooks to a specified target when records are updated in your customers' SaaS tools.

Connectors

See the list of connectors we currently support.

Continue on to the docs to go through our quickstart.

Common use cases

Lead scoring: sync CRM records into your application to power your proprietary rules and AI/ML models.
CRM enrichment: log emails, tasks, and product usage metrics to your customers' CRM and sales engagement tools.
Workflow automation: trigger customer-facing notifications and workflows in real-time based on changes in their SaaS tools.

Roadmap

Check out our roadmap to get informed on what we are currently working on, and what we have in mind for the next weeks, months, and quarters.

Community

For general help using Supaglue, please refer to our documentation. For additional help, you can use one of these channels to chat with us:

Slack - Discuss Supaglue with the team and other developers
Github - File bug reports and make code contributions
Twitter - Get the latest news and announcements

Contributing

Learn about ways to contribute to Supaglue.

License

MIT License.

supaglue's People

Contributors

Stargazers

Watchers

Forkers

rorcde dorucioclea dolaradesara xpcv1 kyang222 dedurus tlkrs 0x4248 mindkhichdi crossk3 fairhopeweb makwana-ashish mohinsandhi lekkodev annaburlyaeva tessoudali tanjawa schenktobi hyperengage arafat-al-mahmud cvikasreddy akshath-nagulapally pankajk07 sumanthreddyc iamsmnt nmasella bharathvaj-ganesan samwaterbury ashokcherukuri jepcastelein timnz devdoshi ivicac aiforacause sarveshraj bhaskarmurthy liemlhdbeatvn vincent-liuwingsang mykas aiseei caherrerapa moesaleh oferkirsh zonalds navabrind bartylla gaspb riffus obsdeck yubozhao dexit assure-thinktech lacoz ariaseta itsbrex cssango reconbug

Ability to create/edit/delete webhooks subscriptions from the Management portal

_{From SyncLinear.com | SUP1-129}

[SUP1-53] Sync error notification webhook

Successful/errored connections
Successful/errored syncs

Top-level (not per-integration)

_{From SyncLinear.com | SUP1-53}

Signup
Integration mgmt
Customer mgmt
Connection mgmt

_{From SyncLinear.com | SUP1-57}

[SUP1-69] [SUP1-17] Logs and API for api requests

_{From SyncLinear.com | SUP1-17}

_SUP1-69

[SUP1-114] Pass-through API

A way to call arbitrary Hubspot V3 endpoints and payload
Using the OAuth credentials that have been stored for a connection

_{From SyncLinear.com | SUP1-114}

E.g. Staging and Production

_{From SyncLinear.com | SUP1-161}

"errors":[{"message":"The OAuth token used to make this call expired 92 minute(s) ago."}]}}%

_{From SyncLinear.com | SUP1-190}

Potentially look into automating this

_{From SyncLinear.com | SUP1-81}

[SUP1-185] Org and account isolations

_{From SyncLinear.com | SUP1-185}

[SUP1-191] Document field mappings/values between Supaglue common model and CRMs schemas (copy)

E.g. closedwon stage in HubSpot should be an enum not string cc @albertyfwu

Otherwise will run into validation error on HubSpot side.

Is the closedwon comment a separate task? It sounds like we want to:

Document field mappings/values.

Change our Opportunity common model's status field (which maps to hubspot stage) to be an enum not string.

If that's the case:

For documenting, why can't we just link to the mapping file for now? Any person who really cares while using this product is an engineer. Not all mappings are straightforward where field foo maps to field bar. Some of them are collected into lists, deduped, etc. The code is not that hard to read. For example: https://github.com/supaglue-labs/supaglue/blob/main/packages/core/remotes/crm/hubspot/mappers.ts#L150

We can't make it an enum because people can have their own custom stages (like in Salesforce). We should either keep it a string or do what merge.dev does and have a separate common model to keep track of the stages (which can be custom).

_{From SyncLinear.com | SUP1-191}

[SUP1-88] Custom field writes

Ability to write/update custom properties on common schema objects, when the custom property has already been created.

_{From SyncLinear.com | SUP1-88}

[SUP1-21] hubspot token refresh

supaglue-wip-sync-worker-1  |     error: {
supaglue-wip-sync-worker-1  |       "code": 401,
supaglue-wip-sync-worker-1  |       "body": {
supaglue-wip-sync-worker-1  |         "status": "error",
supaglue-wip-sync-worker-1  |         "message": "The OAuth token used to make this call expired 9 minute(s) ago.",
supaglue-wip-sync-worker-1  |         "correlationId": "c4736101-d43e-49bc-a348-d3c754a8a13e",
supaglue-wip-sync-worker-1  |         "category": "EXPIRED_AUTHENTICATION",
supaglue-wip-sync-worker-1  |         "context": {
supaglue-wip-sync-worker-1  |           "expire time": [
supaglue-wip-sync-worker-1  |             "2023-02-27T22:10:17.518Z"
supaglue-wip-sync-worker-1  |           ]
supaglue-wip-sync-worker-1  |         }
supaglue-wip-sync-worker-1  |       },
supaglue-wip-sync-worker-1  |       "headers": {
supaglue-wip-sync-worker-1  |         "access-control-allow-credentials": "false",
supaglue-wip-sync-worker-1  |         "alt-svc": "h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400",
supaglue-wip-sync-worker-1  |         "cf-cache-status": "DYNAMIC",
supaglue-wip-sync-worker-1  |         "cf-ray": "7a044e875c87981e-SJC",
supaglue-wip-sync-worker-1  |         "connection": "close",
supaglue-wip-sync-worker-1  |         "content-length": "240",
supaglue-wip-sync-worker-1  |         "content-type": "application/json;charset=utf-8",
supaglue-wip-sync-worker-1  |         "date": "Mon, 27 Feb 2023 22:20:15 GMT",
supaglue-wip-sync-worker-1  |         "nel": "{\"success_fraction\":0.01,\"report_to\":\"cf-nel\",\"max_age\":604800}",
supaglue-wip-sync-worker-1  |         "report-to": "{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=W44aRrhvNCbCBECSh5em2fUsTKSslOLmitk6Kg9eHxOU8Af5%2FGkNfQMu3fGzdAJksf%2BS9TdWzUxHJFEDpgxh%2FsY9JFLOK%2FqUKPjQcwJZ%2FXwI%2F8UnOSst5XHHVDoMvIaG\"}],\"group\":\"cf-nel\",\"max_age\":604800}",
supaglue-wip-sync-worker-1  |         "server": "cloudflare",
supaglue-wip-sync-worker-1  |         "strict-transport-security": "max-age=31536000; includeSubDomains; preload",
supaglue-wip-sync-worker-1  |         "vary": "origin, Accept-Encoding",
supaglue-wip-sync-worker-1  |         "x-hubspot-auth-failure": "401 Unauthorized",
supaglue-wip-sync-worker-1  |         "x-hubspot-correlation-id": "c4736101-d43e-49bc-a348-d3c754a8a13e",
supaglue-wip-sync-worker-1  |         "x-trace": "2B26033CDE1B3B33A4CD144E2361FE2C9FA6D4A263000000000000000000"
supaglue-wip-sync-worker-1  |       }
supaglue-wip-sync-worker-1  |     }

_{From SyncLinear.com | SUP1-21}

Infrastructure
[ ]

_{From SyncLinear.com | SUP1-56}

Change sync frequencies per object

_{From SyncLinear.com | SUP1-34}

[SUP1-153] Malformed search query 502 response

{
    "filters": {
        "asdf": {
            "type": "equals",
            "value": "supergrain.com"
        }
    }
}

<html>

<head>
	<meta http-equiv="content-type" content="text/html;charset=utf-8">
	<title>502 Server Error</title>
</head>

<body text=#000000 bgcolor=#ffffff>
	<h1>Error: Server Error</h1>
	<h2>The server encountered a temporary error and could not complete your request.<p>Please try again in 30 seconds.
	</h2>
	<h2></h2>
</body>

</html>

_{From SyncLinear.com | SUP1-153}