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

# n8n

> Configurá solicitudes a la API de ContactShip desde n8n con autenticación x-api-key y verificá resultados y reintentos.

export const Availability = ({lang = 'es', plan, addon, permission, route, status}) => {
  const L = lang === 'en' ? {
    plan: 'Plan',
    addon: 'Add-on',
    permission: 'Permission',
    route: 'Where',
    status: 'Status',
    addonNote: 'enabled on request',
    allPlans: 'All plans',
    beta: 'Beta',
    nuevo: 'New',
    soon: 'Coming soon'
  } : {
    plan: 'Plan',
    addon: 'Add-on',
    permission: 'Permiso',
    route: 'Dónde',
    status: 'Estado',
    addonNote: 'se activa a pedido',
    allPlans: 'Todos los planes',
    beta: 'Beta',
    nuevo: 'Nuevo',
    soon: 'Próximamente'
  };
  const items = [];
  if (plan) items.push([L.plan, plan]);
  if (addon) items.push([L.addon, `${addon} · ${L.addonNote}`]);
  if (permission) items.push([L.permission, permission]);
  if (route) items.push([L.route, route]);
  if (status) items.push([L.status, L[status] || status]);
  return <div style={{
    display: 'flex',
    flexWrap: 'wrap',
    gap: '6px 22px',
    padding: '12px 16px',
    margin: '4px 0 24px',
    border: '1px solid rgba(2, 82, 255, 0.28)',
    borderLeft: '3px solid #0252ff',
    borderRadius: '8px',
    background: 'rgba(2, 82, 255, 0.05)',
    fontSize: '13.5px',
    lineHeight: '1.5'
  }}>
      {items.map(([k, v]) => <div key={k} style={{
    display: 'flex',
    gap: '6px',
    alignItems: 'baseline'
  }}>
          <span style={{
    fontSize: '10.5px',
    fontWeight: 600,
    letterSpacing: '0.07em',
    textTransform: 'uppercase',
    opacity: 0.65
  }}>{k}</span>
          <span style={{
    fontWeight: 500
  }}>{v}</span>
        </div>)}
    </div>;
};

<Availability lang="es" route="n8n → HTTP Request" />

Podés integrar n8n mediante la API pública de ContactShip. Necesitás una clave de la organización y un plan con acceso API.

## Primera consulta

En un nodo **HTTP Request**, elegí método GET y URL `https://api.contactship.ai/v1/credits`. Configurá una credencial de encabezado con nombre `x-api-key` y el valor de tu clave. Ejecutá la consulta y revisá la respuesta. El nodo permite configurar método, URL y autenticación; consultá la [guía oficial de HTTP Request](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/).

Esta consulta lee créditos; no inicia llamadas. Una respuesta de autenticación fallida no confirma que el endpoint consultado exista.

## Pasar a una acción

Elegí el endpoint en la referencia de API y copiá su método, ruta y parámetros. Para crear llamadas, comprobá agente, contacto o teléfono y número de salida según el endpoint. Probá con un destino controlado antes de conectar una lista.

## Procesar resultados

El inicio de una llamada y su análisis son etapas diferentes. Si tu flujo necesita resumen o datos extraídos, procesá el evento de análisis.

Guardá identificadores para reconocer operaciones ya procesadas. No reintentes ciegamente una solicitud que puede haber iniciado una llamada: consultá su estado antes.

## Nodos comunitarios

Si usás un nodo comunitario ya instalado, comprobá sus operaciones y autenticación contra esta referencia. No asumas que todos los nodos cubren los endpoints actuales.

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Necesito instalar un nodo comunitario?">
    Podés usar solicitudes HTTP a la API pública. Si elegís un nodo específico, verificá que su autenticación y sus operaciones estén actualizadas.
  </Accordion>

  <Accordion title="¿Uso Bearer o x-api-key?">
    La API pública documentada aquí recibe la clave en `x-api-key`. No cambies el esquema de autenticación por el de otro servicio.
  </Accordion>

  <Accordion title="¿Un error significa que puedo repetir la llamada?">
    No necesariamente. Comprobá si la operación se creó antes de repetir una solicitud que inicia llamadas.
  </Accordion>
</AccordionGroup>

## Ver también

* [API Reference](/api-reference/introduction)
* [Claves API](/es/organizacion/claves-api)
* [Webhooks](/es/llamadas/webhooks)