bfocus 0.2.1 → 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +4 -1
- data/lib/bfocus/resources/people.rb +12 -5
- data/lib/bfocus/version.rb +1 -1
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: cde8597ee9adbdde78b052fc3527eb19ed6a5045f73829424d835f696dcd95c9
|
|
4
|
+
data.tar.gz: 867ddf4b2644cbe30252ac5ca6d482e6a4a5216049a4469e6f5f2d5ed4f5757b
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 7a5abc2452240b5f164b164e72bb4e2d895cd70e4ff6479f64d7ba39fa34ecbf0af48e32d75c3c5fe97642f566edf0007e23ab3ec0c8ea921140bbc62614ecda
|
|
7
|
+
data.tar.gz: 91a342991a7a3859e6664b94bd73282fe1d3892226de023372243325bb3a2f738c580575126e0fda360298b310b8b36eed00118165540331f24c9591450add7f
|
data/README.md
CHANGED
|
@@ -190,7 +190,10 @@ client.people.upsert("erp-1042", "app-77", access: true) # devolve o acesso
|
|
|
190
190
|
|
|
191
191
|
- **Nunca duplica.** O e-mail (ou o telefone) acha a pessoa que já chegou por e-mail, pelo widget
|
|
192
192
|
ou por outro sistema, e ela é **adotada** (ganha o seu `external_id`).
|
|
193
|
-
- A mesma pessoa enviada com **outro cliente** é
|
|
193
|
+
- A mesma pessoa enviada com **outro cliente** NÃO é transferida: fica **ligada** também a ele
|
|
194
|
+
(`"linked" => true` na resposta). O cadastro é único e a mesma pessoa circula por vários clientes.
|
|
195
|
+
- **O acesso é do vínculo.** `delete` (e `access: false`) tira o acesso dela NESTE cliente, não nos
|
|
196
|
+
outros: `"unlinked" => true` na resposta quer dizer que ela segue ativa em algum outro.
|
|
194
197
|
- Como no resto da SDK, só o que você passa muda; `nil` limpa (`phone: nil`).
|
|
195
198
|
- Campos: `name`, `email`, `phone`, `role`, `access` (pode usar o atendimento), `is_primary`
|
|
196
199
|
(contato principal), `extra_emails`, `extra_phones`, `custom_fields`, `clear`.
|
|
@@ -69,8 +69,9 @@ module Bfocus
|
|
|
69
69
|
# `PUT /customers/{customer_external_id}/people/{person_external_id}`
|
|
70
70
|
#
|
|
71
71
|
# Só o que vier muda; `nil` limpa. O e-mail (ou telefone) acha a pessoa que já chegou por
|
|
72
|
-
# outro caminho e ela é adotada, nunca duplicada
|
|
73
|
-
# transferida
|
|
72
|
+
# outro caminho e ela é adotada, nunca duplicada. Se ela já existia em OUTRO cliente, NÃO é
|
|
73
|
+
# transferida: fica ligada também a este (cadastro único, `"linked" => true` na resposta).
|
|
74
|
+
# `access: true` devolve o acesso retirado por {#delete}.
|
|
74
75
|
#
|
|
75
76
|
# @param access [Boolean] pode abrir chamados/usar o widget.
|
|
76
77
|
# @param is_primary [Boolean] contato principal do cliente.
|
|
@@ -88,7 +89,9 @@ module Bfocus
|
|
|
88
89
|
# PRÓPRIA ficha: alcançando a pessoa por um identificador EXTRA, a API recusa (409
|
|
89
90
|
# `PERSON_CLEAR_NOT_OWN_RECORD`) — apagar contato de ficha alcançada por apelido seria
|
|
90
91
|
# apagar dado de outro sistema.
|
|
91
|
-
# @return [Hash] a pessoa + `"status"
|
|
92
|
+
# @return [Hash] a pessoa + `"status"`, `"linked"` (já existia em outro cliente e agora está
|
|
93
|
+
# ligada a este também) e `"merged_into"` (o id que você mandou era um apelido; este é o
|
|
94
|
+
# principal do cadastro).
|
|
92
95
|
def upsert(customer_external_id, person_external_id, name: UNSET, email: UNSET, phone: UNSET,
|
|
93
96
|
role: UNSET, access: UNSET, is_primary: UNSET, extra_emails: UNSET, extra_phones: UNSET,
|
|
94
97
|
custom_fields: UNSET, clear: UNSET, idempotency_key: nil, timeout: nil)
|
|
@@ -110,9 +113,13 @@ module Bfocus
|
|
|
110
113
|
timeout: timeout)
|
|
111
114
|
end
|
|
112
115
|
|
|
113
|
-
# Retira o acesso da pessoa (ela continua no histórico).
|
|
116
|
+
# Retira o acesso da pessoa NESTE cliente (ela continua no histórico).
|
|
114
117
|
# `DELETE /customers/{customer_external_id}/people/{person_external_id}`
|
|
115
|
-
#
|
|
118
|
+
#
|
|
119
|
+
# O acesso é DO VÍNCULO: a mesma pessoa circula por vários clientes e tirar o acesso aqui
|
|
120
|
+
# não tira o dela nos outros.
|
|
121
|
+
# @return [Hash] a pessoa, com `"access" => false` e `"unlinked"` (`true` = ela segue ativa
|
|
122
|
+
# em outros clientes; `false` = era só deste e foi desligada).
|
|
116
123
|
def delete(customer_external_id, person_external_id, idempotency_key: nil, timeout: nil)
|
|
117
124
|
cid = segment(customer_external_id, "customer_external_id")
|
|
118
125
|
pid = segment(person_external_id, "person_external_id")
|
data/lib/bfocus/version.rb
CHANGED