Administrar clientes

Instalá la Skill de Commet para que tu agente integre clientes usando el contrato actual de la API.

npx skills add commet-labs/skills --skill commet

Un customer representa a la empresa o persona que vas a cobrar. Cada customer puede tener una relación de suscripción activa a la vez.

Dashboard

Entrá a Customers para buscar clientes, revisar su estado de facturación, asignar un plan y administrar la suscripción.

Crear un customer

import { Commet } from "@commet/node";

const commet = new Commet({ apiKey: "ck_xxx" });

const customer = await commet.customers.create({ email: "user@example.com" });

from commet import Commet

commet = Commet("ck_xxx")

customer = commet.customers.create(email="user@example.com")

client, err := commet.New("ck_xxx")
if err != nil {
	log.Fatal(err)
}
ctx := context.Background()

customer, err := client.Customers.Create(ctx, &commet.CreateCustomerParams{
	Email: "user@example.com",
})
if err != nil {
	log.Fatal(err)
}

import co.commet.Commet;
import co.commet.params.CreateCustomerParams;

var commet = Commet.builder().apiKey("ck_xxx").build();

var customer = commet.customers().create(
    CreateCustomerParams.builder("user@example.com").build()
);

use Commet\Commet;

$commet = new Commet('ck_xxx');

$customer = $commet->customers->create(email: 'user@example.com');

create es idempotente cuando enviás tu propio id: un reintento con el mismo ID devuelve el customer existente. Usá:

id para el identificador estable de tu aplicación.
email para comunicaciones de facturación.
address y taxDocument para el contexto de facturación e impuestos.
metadata para valores propios de tu aplicación que no controlen comportamiento de billing.

Crear customers en batch

import { Commet } from "@commet/node";

const commet = new Commet({ apiKey: "ck_xxx" });

const customerBatch = await commet.customers.createBatch({ customers: [{ email: "user@example.com" }] });

from commet import Commet

commet = Commet("ck_xxx")

customer_batch = commet.customers.create_batch(customers=[{"email": "user@example.com"}])

client, err := commet.New("ck_xxx")
if err != nil {
	log.Fatal(err)
}
ctx := context.Background()

customerBatch, err := client.Customers.CreateBatch(ctx, &commet.BatchCreateCustomersParams{
	Customers: []commet.BatchCreateCustomersParamsCustomersItem{{
		Email: "user@example.com",
	}},
})
if err != nil {
	log.Fatal(err)
}

import co.commet.Commet;
import co.commet.models.BatchCreateCustomersParamsCustomersItem;
import co.commet.params.BatchCreateCustomersParams;
import java.util.List;

var commet = Commet.builder().apiKey("ck_xxx").build();

var customerBatch = commet.customers().createBatch(
    BatchCreateCustomersParams.builder(List.of(new BatchCreateCustomersParamsCustomersItem("user@example.com", null, null, null, null, null, null, null))).build()
);

use Commet\Commet;

$commet = new Commet('ck_xxx');

$customerBatch = $commet->customers->createBatch(
    customers: [['email' => 'user@example.com']],
);

Un batch acepta hasta 100 customers y devuelve por separado los elementos exitosos y fallidos.

Obtener un customer

import { Commet } from "@commet/node";

const commet = new Commet({ apiKey: "ck_xxx" });

const customer = await commet.customers.get({ id: "cus_xxx" });

from commet import Commet

commet = Commet("ck_xxx")

customer = commet.customers.get("cus_xxx")

client, err := commet.New("ck_xxx")
if err != nil {
	log.Fatal(err)
}
ctx := context.Background()

customer, err := client.Customers.Get(ctx, "cus_xxx")
if err != nil {
	log.Fatal(err)
}

import co.commet.Commet;

var commet = Commet.builder().apiKey("ck_xxx").build();

var customer = commet.customers().get("cus_xxx");

use Commet\Commet;

$commet = new Commet('ck_xxx');

$customer = $commet->customers->get(id: 'cus_xxx');

Actualizar un customer

import { Commet } from "@commet/node";

const commet = new Commet({ apiKey: "ck_xxx" });

const customer = await commet.customers.update({ id: "cus_xxx" });

from commet import Commet

commet = Commet("ck_xxx")

customer = commet.customers.update("cus_xxx")

client, err := commet.New("ck_xxx")
if err != nil {
	log.Fatal(err)
}
ctx := context.Background()

customer, err := client.Customers.Update(ctx, "cus_xxx", nil)
if err != nil {
	log.Fatal(err)
}

import co.commet.Commet;
import co.commet.params.UpdateCustomerParams;

var commet = Commet.builder().apiKey("ck_xxx").build();

var customer = commet.customers().update(
    "cus_xxx",
    UpdateCustomerParams.builder().build()
);

use Commet\Commet;

$commet = new Commet('ck_xxx');

$customer = $commet->customers->update(id: 'cus_xxx');

Las actualizaciones usan semántica PATCH: enviá solamente los campos que deben cambiar.

Listar customers

import { Commet } from "@commet/node";

const commet = new Commet({ apiKey: "ck_xxx" });

const response = await commet.customers.list();

from commet import Commet

commet = Commet("ck_xxx")

customers_list_result = commet.customers.list()

client, err := commet.New("ck_xxx")
if err != nil {
	log.Fatal(err)
}
ctx := context.Background()

customersListResult, err := client.Customers.List(ctx, nil)
if err != nil {
	log.Fatal(err)
}

import co.commet.Commet;
import co.commet.params.ListCustomersParams;

var commet = Commet.builder().apiKey("ck_xxx").build();

var customersListResult = commet.customers().list(ListCustomersParams.builder().build());

use Commet\Commet;

$commet = new Commet('ck_xxx');

$customersListResult = $commet->customers->list();

Las listas devuelven { object, data, hasMore, nextCursor }. Enviá nextCursor como cursor para pedir la siguiente página. Las operaciones individuales devuelven el customer directamente. Consultá la referencia de Customers para ver los campos exactos de request y response generados.

Inicio rápido

Aprender

Recursos

Plugins

Administrar clientes

Dashboard

Crear un customer

Crear customers en batch

Obtener un customer

Actualizar un customer

Listar customers

Relacionado

​Dashboard

​Crear un customer

​Crear customers en batch

​Obtener un customer

​Actualizar un customer

​Listar customers

​Relacionado

Dashboard

Crear un customer

Crear customers en batch

Obtener un customer

Actualizar un customer

Listar customers

Relacionado