> ## Documentation Index
> Fetch the complete documentation index at: https://dialnexa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Opencage

> Connect DialNexa calls to Opencage for incident, alert, issue, repository, deploy, monitor, log, build, or technical escalation workflows.

OpenCage Geocoder provides a simple API for forward and reverse geocoding using open data sources.

<Note>
  Use Opencage with DialNexa when a caller reports a technical failure, API problem, broken workflow, regression, outage, or engineering escalation.
</Note>

## Where Opencage fits in a DialNexa workflow

Opencage should receive DialNexa output when the conversation affects a incident, alert, issue, repository, deploy, monitor, log, build, or technical escalation. The handoff should explain what the caller asked for, what DialNexa learned, which record or object is affected, and who owns the next step.

<CardGroup cols={2}>
  <Card title="Connect calls to alerts" icon="check-circle">
    Link customer symptoms to monitors, deployments, incidents, repositories, or on-call ownership.
  </Card>

  <Card title="Avoid noisy escalations" icon="check-circle">
    Separate true incidents from setup questions, product confusion, account configuration, and known limitations.
  </Card>

  <Card title="Create incident-ready reports" icon="check-circle">
    Capture affected customer, service, error, region, severity, start time, workaround, and business impact.
  </Card>

  <Card title="Create reproducible issues" icon="check-circle">
    Record expected behavior, actual behavior, steps, endpoint, screenshots or logs mentioned, and account context.
  </Card>
</CardGroup>

## What DialNexa should capture for Opencage

* Customer, account, plan, environment, region, product area, endpoint, and error message
* Severity, business impact, affected users, start time, workaround, and urgency
* Steps described by caller, logs referenced, repo, deploy, monitor, alert, owner, and escalation channel
* Transcript link, recording link, DialNexa call ID, support ticket, CRM account, and status page link
* Privacy note, customer-facing update status, and next update time

## High-value Opencage workflows

<AccordionGroup>
  <Accordion title="Deployment regression appears after release">
    For this workflow, DialNexa should send Opencage a concise, action-ready handoff: matched caller, affected record, reason for the update, urgency, owner, next step, and links to call evidence.
  </Accordion>

  <Accordion title="Caller gives reproducible bug steps">
    DialNexa should write the symptom, expected behavior, actual behavior, affected area, business impact, and evidence links into Opencage. A teammate should be able to triage the issue without replaying the call.
  </Accordion>

  <Accordion title="On-call needs customer impact">
    For this workflow, DialNexa should send Opencage a concise, action-ready handoff: matched caller, affected record, reason for the update, urgency, owner, next step, and links to call evidence.
  </Accordion>

  <Accordion title="Security or abuse issue needs escalation">
    For this scenario, DialNexa should treat Opencage as an escalation destination. Send the impact, urgency, affected customer or object, owner, and transcript link so the right team can act before the issue gets colder.
  </Accordion>

  <Accordion title="Status update should be sent after fix">
    For this workflow, DialNexa should send Opencage a concise, action-ready handoff: matched caller, affected record, reason for the update, urgency, owner, next step, and links to call evidence.
  </Accordion>

  <Accordion title="Support needs logs linked to the ticket">
    For this workflow, DialNexa should send Opencage a concise, action-ready handoff: matched caller, affected record, reason for the update, urgency, owner, next step, and links to call evidence.
  </Accordion>

  <Accordion title="Customer reports an outage">
    For this scenario, DialNexa should treat Opencage as an escalation destination. Send the impact, urgency, affected customer or object, owner, and transcript link so the right team can act before the issue gets colder.
  </Accordion>

  <Accordion title="Use geocode xml">
    Use geocode xml when the call outcome maps clearly to that operation and the required fields, owner, review state, and evidence links are known.
  </Accordion>

  <Accordion title="Use check api health">
    Use check api health when the call outcome maps clearly to that operation and the required fields, owner, review state, and evidence links are known.
  </Accordion>
</AccordionGroup>

## Workflows that pair Opencage with other integrations

* [Opencage](/integrations/opencage) + [Jira](/integrations/jira): Jira for engineering tasks.
* [Opencage](/integrations/opencage) + [Google Docs](/integrations/googledocs): Google Docs for incident notes.
* [Opencage](/integrations/opencage) + [HubSpot](/integrations/hubspot): HubSpot for affected-account visibility.
* [Opencage](/integrations/opencage) + [Datadog](/integrations/datadog): Datadog for monitor context.
* [Opencage](/integrations/opencage) + [GitHub](/integrations/github): GitHub for linked code issues.
* [Opencage](/integrations/opencage) + [Google Sheets](/integrations/googlesheets): Google Sheets for incident review logs.
* [Opencage](/integrations/opencage) + [Zendesk](/integrations/zendesk): Zendesk for customer-facing support records.

## Implementation notes

* Use the DialNexa call ID as the idempotency key before running Opencage actions.
* Write a short operational summary into Opencage and link to the full transcript or recording for audit.
* Map required fields before launch: destination object, owner, status, urgency, next step, and record URL.
* Create review paths for low-confidence matches, sensitive requests, high-value customers, and actions that change money, access, legal terms, or customer commitments.

## FAQs

<AccordionGroup>
  <Accordion title="How do callbacks get tracked?">
    Create a callback task with phone number, preferred time, timezone, owner, attempt count, and the reason for the callback.
  </Accordion>

  <Accordion title="How are duplicate tickets avoided?">
    Search open tickets and recent conversations by customer, phone, email, and issue category before creating anything new.
  </Accordion>

  <Accordion title="What should stay internal?">
    Private account details, agent-only notes, escalation reasoning, and full transcripts should stay internal unless approved for customer messaging.
  </Accordion>

  <Accordion title="How should product feedback be captured?">
    Separate feature request, bug, confusion, missing documentation, and churn risk so product teams can use the signal.
  </Accordion>

  <Accordion title="Should every support call create a ticket?">
    No. Create or update a ticket when the caller needs follow-up, SLA tracking, evidence, escalation, or customer-visible ownership.
  </Accordion>

  <Accordion title="What makes a support handoff useful?">
    Issue, affected product, customer expectation, what DialNexa already checked, urgency, owner, next step, and transcript link.
  </Accordion>
</AccordionGroup>