Slack-kobling

Koble Slack-arbeidsområdet ditt til Brevo via Tajo for sanntidsmarkedsføringsvarslinger, teamvarsler ved kundehendelser og arbeidsflytautomatisering utløst av Slack-interaksjoner.

Oversikt

Funksjoner

• Markedsføringsvarsler - Send sanntidsvarsler for kampanjehendelser, nye abonnenter og inntektsmilepæler
• Kundehendelsesvarsler - Varsle team om verdifulle kundehandlinger fra Brevo
• Arbeidsflytutløsere - Bruk Slack-interaksjoner (knappeklikk, skjemainnsendinger) for å utløse Brevo-automatiseringer
• Kanalbasert ruting - Rut varslinger til bestemte kanaler basert på hendelsestype eller kundesegment
• Brukersynkronisering - Mapp Slack-arbeidsområdebrukere til Brevo-kontakter for intern kommunikasjon
• Interaktive meldinger - Send rike meldinger med knapper og handlinger for teamarbeidsflyter
• Planlagte meldinger - Planlegg varslinger for daglige/ukentlige markedsføringssammendrag
• Trådstøtte - Grupper relaterte varslinger i tråder for organisert kommunikasjon

Forutsetninger

Før du begynner, sørg for at du har:

1. Et Slack-arbeidsområde med administratortilgang
2. En Slack-app opprettet på api.slack.com/apps
3. Bot-token med nødvendige scopes
4. En Brevo-konto med API-tilgang
5. En Tajo-konto

Autentisering

Bot-token (anbefalt)

Installer en Slack-app i arbeidsområdet ditt og bruk bot-tokenet for API-tilgang.

1. Opprett app på api.slack.com/apps
2. Legg til nødvendige OAuth-scopes under “OAuth & Permissions”
3. Installer app i arbeidsområdet
4. Kopier Bot User OAuth Token (xoxb-...)

curl -X POST "https://slack.com/api/chat.postMessage" \
  -H "Authorization: Bearer xoxb-YOUR-BOT-TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"channel": "C01234567", "text": "Hello from Tajo!"}'

OAuth 2.0

For å distribuere Slack-integrasjonen din til flere arbeidsområder:

# Autorisasjons-URL
https://slack.com/oauth/v2/authorize?
  client_id={client_id}&
  scope=chat:write,channels:read,users:read&
  redirect_uri={redirect_uri}

# Token-utveksling
curl -X POST "https://slack.com/api/oauth.v2.access" \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}" \
  -d "code={auth_code}"

Nødvendige bot-scopes

chat:write           # Send meldinger
channels:read        # List kanaler
channels:history     # Les kanalmeldinger
users:read           # List arbeidsområdebrukere
users:read.email     # Les brukerens e-postadresser
reactions:write      # Legg til reaksjoner på meldinger
files:write          # Last opp filer

Konfigurasjon

Grunnleggende oppsett

connectors:
  slack:
    enabled: true
    bot_token: "${SLACK_BOT_TOKEN}"
    signing_secret: "${SLACK_SIGNING_SECRET}"

    # Varslingskanaler
    channels:
      marketing: "C01234567"
      sales: "C01234568"
      support: "C01234569"
      alerts: "C01234570"

    # Hendelsesruting
    notifications:
      new_subscriber:
        channel: marketing
        template: subscriber_alert
      high_value_order:
        channel: sales
        template: order_alert
      support_ticket:
        channel: support
        template: ticket_alert

Feltmapping

Mapp Slack-brukerdata til Brevo-kontaktattributter:

API-metoder

Meldinger

Kanaler

Brukere

Interaksjoner

Hendelser

Brevo-til-Slack-varsler

Slack-til-Brevo-utløsere

Kodeeksempler

Initialiser kobling

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Koble til Slack
await tajo.connectors.connect('slack', {
  botToken: process.env.SLACK_BOT_TOKEN,
  signingSecret: process.env.SLACK_SIGNING_SECRET
});

Send markedsføringsvarsler

// Send et varsel når en verdifull bestilling legges inn
await tajo.slack.notify({
  channel: 'sales',
  event: 'order_placed',
  data: {
    customerEmail: '[email protected]',
    orderValue: '$1,250.00',
    products: ['Premium Widget', 'Pro Service'],
    isFirstOrder: true
  },
  template: {
    blocks: [
      {
        type: 'header',
        text: { type: 'plain_text', text: 'New High-Value Order' }
      },
      {
        type: 'section',
        fields: [
          { type: 'mrkdwn', text: '*Customer:*\n[email protected]' },
          { type: 'mrkdwn', text: '*Amount:*\n$1,250.00' }
        ]
      },
      {
        type: 'actions',
        elements: [
          {
            type: 'button',
            text: { type: 'plain_text', text: 'View in Brevo' },
            url: 'https://app.brevo.com/contacts'
          }
        ]
      }
    ]
  }
});

Håndter Slack-interaksjoner

import crypto from 'crypto';

app.post('/slack/interactions', async (req, res) => {
  // Verifiser Slack-forespørselssignatur
  const timestamp = req.headers['x-slack-request-timestamp'];
  const signature = req.headers['x-slack-signature'];
  const sigBasestring = `v0:${timestamp}:${req.rawBody}`;
  const mySignature = 'v0=' + crypto
    .createHmac('sha256', process.env.SLACK_SIGNING_SECRET)
    .update(sigBasestring)
    .digest('hex');

  if (signature !== mySignature) {
    return res.status(401).send('Unauthorized');
  }

  const payload = JSON.parse(req.body.payload);

  // Håndter knappehandlinger
  if (payload.type === 'block_actions') {
    await tajo.connectors.handleWebhook('slack', {
      type: 'interaction',
      action: payload.actions[0].action_id,
      userId: payload.user.id,
      payload
    });
  }

  res.status(200).send();
});

Ratebegrensninger

Slack APIs ratebegrensninger bruker et nivåsystem:

Ytterligere grenser:

• Web API: Burstgrense med kortvarig struping
• Events API: Leveringsforsøk inntil 3 ganger
• Incoming Webhooks: 1 melding/sekund per webhook-URL
• Block Kit: Maksimalt 50 blokker per melding

Feilsøking

Vanlige problemer

Feilsøkingsmodus

Aktiver utvidet logging:

connectors:
  slack:
    debug: true
    log_level: verbose
    log_events: true

Test tilkobling

tajo connectors test slack
# ✓ Bot-token gyldig
# ✓ Arbeidsområde tilgjengelig
# ✓ Kanaler lesbare
# ✓ Meldingspublisering aktivert
# ✓ Hendelsesabonnementer aktive

Beste praksis

1. Bruk Block Kit - Bygg rike, interaktive meldinger med Slacks Block Kit-rammeverk
2. Svar raskt - Bekreft interaksjoner innen 3 sekunder, behandle asynkront
3. Trådkoble relaterte meldinger - Grupper relaterte varslinger i tråder for å redusere støy
4. Rut etter kanal - Send ulike hendelsestyper til passende teamkanaler
5. Inkluder handlingsknapper - Legg til “View in Brevo”-knapper for rask tilgang til kundedata
6. Implementer unfurling - Vis rike forhåndsvisninger for Brevo-lenker delt i Slack

Sikkerhet

• Bot-token - OAuth-avgrenset tilgangstoken med granulære rettigheter
• Forespørselssignering - HMAC SHA-256-signaturverifisering for innkommende forespørsler
• OAuth 2.0 - Bransjestandard autorisasjon for distribusjon til flere arbeidsområder
• TLS-kryptering - All API-kommunikasjon kryptert via HTTPS
• Tokenrotasjon - Automatisk tokenrotasjon for økt sikkerhet

Relaterte ressurser

• Slack API-dokumentasjon
• Slack Block Kit Builder
• Slack Events API
• Brevo-kobling
• Customer Sync-ferdighet