da80ce3eb1
Drivers whose source API surfaces an account-status signal return every account (including inactive / suspended / deleted) and populate Active accordingly; drivers without such a signal no longer fabricate it. The fetch pipeline records every account with decision PENDING and no flags. Producing flags or a non-PENDING decision is reserved to human reviewers or a purpose-built agent run against the campaign -- the engine must not form an implicit verdict. Signed-off-by: Aurélien Sibiril <81782+aureliensibiril@users.noreply.github.com>
124 lines
3.6 KiB
Go
124 lines
3.6 KiB
Go
// Copyright (c) 2026 Probo Inc <hello@getprobo.com>.
|
|
//
|
|
// Permission to use, copy, modify, and/or distribute this software for any
|
|
// purpose with or without fee is hereby granted, provided that the above
|
|
// copyright notice and this permission notice appear in all copies.
|
|
//
|
|
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
|
|
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
|
|
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
|
|
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
|
|
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
|
|
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
// PERFORMANCE OF THIS SOFTWARE.
|
|
|
|
package drivers
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"fmt"
|
|
"net/http"
|
|
|
|
"go.probo.inc/probo/pkg/coredata"
|
|
)
|
|
|
|
// IntercomDriver fetches workspace admins from Intercom via Bearer
|
|
// token-authenticated REST API requests.
|
|
type IntercomDriver struct {
|
|
httpClient *http.Client
|
|
}
|
|
|
|
var _ Driver = (*IntercomDriver)(nil)
|
|
|
|
type intercomAdminsResponse struct {
|
|
Type string `json:"type"`
|
|
Admins []struct {
|
|
Type string `json:"type"`
|
|
ID string `json:"id"`
|
|
Name string `json:"name"`
|
|
Email string `json:"email"`
|
|
JobTitle string `json:"job_title"`
|
|
HasInboxSeat bool `json:"has_inbox_seat"`
|
|
} `json:"admins"`
|
|
}
|
|
|
|
const (
|
|
intercomAdminsEndpoint = "https://api.intercom.io/admins"
|
|
intercomAPIVersion = "2.11"
|
|
)
|
|
|
|
func NewIntercomDriver(httpClient *http.Client) *IntercomDriver {
|
|
return &IntercomDriver{
|
|
httpClient: httpClient,
|
|
}
|
|
}
|
|
|
|
func (d *IntercomDriver) ListAccounts(ctx context.Context) ([]AccountRecord, error) {
|
|
resp, err := d.fetchAdmins(ctx)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
var records []AccountRecord
|
|
for _, a := range resp.Admins {
|
|
record := AccountRecord{
|
|
Email: a.Email,
|
|
FullName: a.Name,
|
|
Role: intercomRole(a.HasInboxSeat),
|
|
JobTitle: a.JobTitle,
|
|
IsAdmin: false, // Intercom API does not expose admin role information
|
|
ExternalID: a.ID,
|
|
MFAStatus: coredata.MFAStatusUnknown,
|
|
AuthMethod: coredata.AccessEntryAuthMethodUnknown,
|
|
AccountType: coredata.AccessEntryAccountTypeUser,
|
|
}
|
|
|
|
if record.Email != "" || record.FullName != "" {
|
|
records = append(records, record)
|
|
}
|
|
}
|
|
|
|
return records, nil
|
|
}
|
|
|
|
func (d *IntercomDriver) fetchAdmins(ctx context.Context) (*intercomAdminsResponse, error) {
|
|
req, err := http.NewRequestWithContext(ctx, http.MethodGet, intercomAdminsEndpoint, nil)
|
|
if err != nil {
|
|
return nil, fmt.Errorf("cannot create intercom admins request: %w", err)
|
|
}
|
|
|
|
req.Header.Set("Accept", "application/json")
|
|
req.Header.Set("Intercom-Version", intercomAPIVersion)
|
|
|
|
httpResp, err := d.httpClient.Do(req)
|
|
if err != nil {
|
|
return nil, fmt.Errorf("cannot execute intercom admins request: %w", err)
|
|
}
|
|
defer func() {
|
|
_ = httpResp.Body.Close()
|
|
}()
|
|
|
|
if httpResp.StatusCode < 200 || httpResp.StatusCode >= 300 {
|
|
return nil, fmt.Errorf("cannot fetch intercom admins: unexpected status %d", httpResp.StatusCode)
|
|
}
|
|
|
|
var resp intercomAdminsResponse
|
|
if err := json.NewDecoder(httpResp.Body).Decode(&resp); err != nil {
|
|
return nil, fmt.Errorf("cannot decode intercom admins response: %w", err)
|
|
}
|
|
|
|
return &resp, nil
|
|
}
|
|
|
|
// intercomRole returns a role label based on whether the admin has an inbox
|
|
// seat. The Intercom API does not expose a proper role field, so this is the
|
|
// best approximation available: users with inbox seats are active agents,
|
|
// those without are limited/viewer users.
|
|
func intercomRole(hasInboxSeat bool) string {
|
|
if hasInboxSeat {
|
|
return "Agent"
|
|
}
|
|
return "Viewer"
|
|
}
|